動的取り込み API:ベストプラクティス

はじめに

Dynamic Ingest APIは強力で柔軟ですが、この機能を最も効果的に使用するには、以下に詳述するいくつかのベストプラクティスに従う必要があります。

ベストプラクティス

動的取り込みのルールとガイドラインを次に示します。

•  同じアセットに対して重複ジョブを処理しないでください。このインスタンスのアセットは、ビデオオブジェクト、特定の言語のオーディオトラック、特定の言語のテキストトラック、または特定のイメージタイプとして定義されます。ポイントを説明するいくつかの例を次に示します。
  • 受け入れられない:ビデオファイルの取り込みリクエストを送信し、最初の取り込みジョブが完了する前に、同じビデオ ID を持つ別のビデオ取り込みリクエストを送信する
  • 許容可能:ビデオファイルの取り込みリクエストを送信し、同じ動画 ID に関連付けられた英語のテキストトラックに対するインジェストリクエストを送信し、同じ動画 ID のサムネイル画像に対するインジェストリクエストを送信します。
  • 許容可能:テキストトラックのインジェストジョブを英語で送信し、スペイン語のテキストトラックのインジェストリクエストを並行して送信する
  • 受け入れられない:スペイン語のオーディオトラックを取り込むリクエストを送信し、すぐに同じビデオ ID で別のスペイン語のオーディオトラックを取り込むリクエストを送信する
  • profile 取り込み要求のフィールドはオプションです。profile アプリおよびインテグレーションでをハードコーディングすることは避けてください。代わりに、最もよく使用されるプロファイルをアカウントのデフォルトとして設定し、フィールドを省略するか、アカウントで利用可能なプロファイルを取得し、ユーザーに 1 つ選択するように強制します。
• Dynamic Ingestおよびのリクエストの合計に対する、各アカウントの 20 CMS APIリクエスト/秒の制限です。
• アカウントごとに 100 の同時優先順位 DI ジョブに制限があります。
• 大量のファイルを取り込む場合は、100 個を超えるジョブをキューに入れることができる低優先度キューの使用を検討してください。
• コンテンツの取り込みは、通常、1 ファイルあたり 100 GB に制限されます (大きなファイルを取り込む必要がある場合は、アカウントマネージャーにお問い合わせください)。
• ファイルをバッチで取り込む場合、同時通常の優先度ジョブを 100 に制限し、1 つのジョブの処理が完了するまで待ってから別のジョブを追加します。詳細については、「フォールバック/再試行戦略」を参照してください。
• 完全なバッチを取り込む前に、取り込みプロファイルの変更を検証して、必要な結果が得られることを確認します。