よくある質問

構造化データファイル(SDF)アップロード API の試験運用機能にアクセスできるのは誰ですか?

advertisers.sdfuploadtasks.upload メソッドは、許可リストに追加された Google Cloud プロジェクトでのみ使用できます。

パイロット版の機能をサポートしている API バージョンはどれですか?

SDF アップロード API のトライアル版は、ディスプレイ&ビデオ 360 API v4 でのみサポートされています。

パイロット版ではどの SDF バージョンがサポートされていますか?

SDF アップロード API の試験運用版を使用する場合は、SDF v9.2 を使用することをおすすめします。SDF v9 より前のバージョンから移行する場合は、v9 移行ガイドをご覧ください。

プロジェクトが許可リストに追加されているかどうかを確認するにはどうすればよいですか?

この URL にプロジェクトから生成された API キーを挿入し、URL をコピーしてブラウザに貼り付けます。

https://displayvideo.googleapis.com/$discovery/rest?version=v4&labels=SDF_UPLOAD_ALPHA&key=API_KEY

API の JSON 説明が表示された場合は、プロジェクトが許可リストに追加されています。エラーが表示された場合は、プロジェクトが追加されていません。

どのクライアント ライブラリがサポートされていますか?

{ api_name } の試験運用版機能にアクセスするには、Python 用の Google API クライアント ライブラリのみを使用できます。パイロット機能を活用できる承認済みサービス オブジェクトを作成するには、構成手順をご覧ください。

SDF に含めることができるエントリの数に上限はありますか?

SDF のエントリの上限は 10,000 件です。この上限を超えるファイルをアップロードしようとすると、エラーが発生します。

アップロードできる SDF の数に上限はありますか?

Google Cloud プロジェクトでは、ディスプレイ&ビデオ 360 API を使用して、1 日に広告主様 1 社あたり 30 個の SDF をアップロードできます。1 日は米国太平洋時間帯(PST)の午前 0 時に始まります。

advertisers.sdfuploadtasks.upload リクエストが失敗した場合や、アップロード `Operation がエラーで終了した場合、試行は関連する割り当てにカウントされません。

一度にアップロードできる SDF の数はいくつですか?

advertisers.sdfuploadtasks.upload リクエストでアップロードできるのは 1 つのファイルのみです。

ディスプレイ&ビデオ 360 の 1 人のユーザーが同時に処理できる SDF アップロード タスクは 20 個までです。20 個のファイルをアップロードした場合は、いずれかのファイルの処理が完了するまで待ってから、別のファイルをアップロードする必要があります。

429 エラーが表示されるのはなぜですか?

429 エラーが表示される場合は、1 日に 1 つの広告主でアップロードできる SDF の数を超えている可能性があります。ディスプレイ&ビデオ 360 API を使用して関連する広告主の追加の SDF をアップロードする前に、翌日まで待ちます。

別の割り当てを超えていると思われる場合は、制限の定義については標準 API の使用制限、割り当ての使用を制限するためのベスト プラクティスについては割り当ての最適化ガイドをご覧ください。