入門
Dynamic Ingest APIは強力で柔軟性がありますが、最も効果的に使用するには、以下に詳述するいくつかのベストプラクティスに従う必要があります。
ベストプラクティス
動的取り込みのルールとガイドラインを次に示します。
profile取り込み要求のフィールドはオプションです。profileアプリおよびインテグレーションでをハードコーディングすることは避けてください。代わりに、最もよく使用されるプロファイルをアカウントのデフォルトとして設定し、フィールドを省略するか、アカウントで利用可能なプロファイルを取得し、ユーザーに 1 つ選択するように強制します。- 同じ動画に対して、1分あたり最大10リクエストまでに制限されています。
- 同じ動画に対して、重複するジョブを同時に処理しないでください。ただし、同じジョブ内で動画と一緒に画像やテキストトラックなどのアセットを取り込むことは問題ありません。
同じ動画IDに対して複数のジョブが作成される可能性がある自動化プロセスを使用している場合は、新しい動画を作成する前に通知を確認し、同じ動画で他のジョブが処理されていないことを確認してください。
- Dynamic IngestおよびCMS APIへのリクエスト合計について、アカウントごとに1秒あたり20リクエストの制限があります。
- 各アカウントでは、最大1,000件の同時取り込みジョブと、1分あたり最大3,000件の取り込みジョブの送信がサポートされています。これらの上限を超えた場合、超過したジョブはキューに入れられ、可能な限り早く処理されます。大量のバッチや移行を手動でスロットリングする必要はありません。
- 大量のバッチや移行では、通知を使用して各ジョブの完了を追跡してください。キューに入れられたジョブは、CMS APIでは処理中のジョブと同じく
pendingのステータスになります。 - 取り込むコンテンツのファイルサイズに制限はありませんが、動画の長さは24時間が上限です。
- 全件取り込みを実行する前に、インジェストプロファイルの変更を検証し、期待どおりの結果が得られることを確認してください。