構造化データファイル(SDF)アップロード API の試験運用機能にアクセスできるのは誰ですか?
advertisers.sdfuploadtasks.upload メソッドは、許可リストに追加された Google Cloud プロジェクトでのみ使用できます。
パイロット機能をサポートしている API バージョン
SDF アップロード API の試験運用版は、ディスプレイ&ビデオ 360 API v4 でのみサポートされています。
このパイロット版ではどの SDF バージョンがサポートされていますか?
SDF Upload API パイロットを使用する場合は、SDF v9.2 以降を使用することをおすすめします。
プロジェクトが許可リストに追加されたかどうかを確認するにはどうすればよいですか?
プロジェクトから生成された API キーをこの URL に挿入し、URL をコピーしてブラウザに貼り付けます。
https://displayvideo.googleapis.com/$discovery/rest?version=v4&labels=SDF_UPLOAD_ALPHA&key=API_KEYAPI の JSON 記述が表示された場合は、プロジェクトが許可リストに追加されています。エラーが表示された場合、プロジェクトは追加されていません。
サポートされているクライアント ライブラリ
Display & Video 360 API のパイロット機能にアクセスするには、Python 用 Google API クライアント ライブラリのみを使用できます。パイロット機能を利用できる承認済みサービス オブジェクトを作成するには、構成手順をご覧ください。
SDF に含めることができるエントリ数に上限はありますか?
SDF のエントリ数の上限は 10,000 件です。この上限を超えるファイルをアップロードしようとすると、エラーが発生します。
アップロードできる SDF の数に上限はありますか?
Google Cloud プロジェクトでは、ディスプレイ&ビデオ 360 API を使用して、広告主ごとに 1 日あたり 30 個の SDF をアップロードできます。1 日は米国太平洋タイムゾーン(PST)の午前 0 時に始まります。
advertisers.sdfuploadtasks.upload リクエストが失敗した場合、またはアップロード Operation がエラーで終了した場合、その試行は関連する割り当てにカウントされません。
一度にアップロードできる SDF の数はいくつですか?
各 advertisers.sdfuploadtasks.upload リクエストでアップロードできるのは 1 つのファイルのみです。
1 人のディスプレイ&ビデオ 360 ユーザーが同時に処理できる SDF アップロード タスクは 20 個までです。20 個のファイルをアップロードした場合は、いずれかのファイルの処理が完了するまで待ってから、別のファイルをアップロードする必要があります。
429 エラーが表示されるのはなぜですか?
429 エラーが発生している場合は、1 日に広告主の下でアップロードできる SDF の数を超えている可能性があります。ディスプレイ&ビデオ 360 API を使用して、関連する広告主の追加の SDF をアップロードする前に、翌日まで待ちます。
別の割り当てを超えていると思われる場合は、標準 API の使用量上限で上限の定義を確認し、割り当て最適化ガイドで割り当て使用量を制限するためのベスト プラクティスを確認してください。