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