ディスプレイとVideo 360 API v2 は廃止されます。[ディスプレイとVideo 360 API v3 を使用してください。v2 から v3 への移行手順については、移行ガイドをご覧ください。

このページは Cloud Translation API によって翻訳されました。

よくある質問

一般

API の最新バージョンを教えてください。

このドキュメントで対応している API の最新バージョンは v3 です。

この API を使用してパフォーマンスデータを取得できますか？

いいえ。ディスプレイ &ビデオ 360 オフラインレポートを作成、取得、実行するには、Bid Manager API を使用します。

API を使用する

API へのアクセスに使用する URL

https://displayvideo.googleapis.com

どのような認証方法がサポートされていますか？

サポートされている認証方法は OAuth 2.0 のみです。

Display & Video 360 API リクエストは、次のスコープについて承認する必要があります。

https://www.googleapis.com/auth/display-video

users サービスへのリクエストは、次の追加スコープで承認される必要もあります。

https://www.googleapis.com/auth/display-video-user-management

コードを記述したい。クライアントライブラリの場所

クライアントライブラリガイドをご覧ください。

クライアントライブラリを使用しない場合

Google のクライアントライブラリのいずれかを使用することをおすすめしますが、直接 HTTP リクエストを使って Display & Video 360 API を操作することもできます。

一部の複雑なメソッド（advertisers.assets.upload や media.upload など）は、HTTP リクエストに直接変換するのは困難です。クリエイティブとカスタム入札のガイドで、cURL を使用してこれらのメソッドに HTTP リクエストする例をご覧ください。

ディスプレイ &ビデオ 360 で必要な権限

Display & Video 360 API を使用するには、認証する Google アカウントは、関連するパートナーまたは広告主へのアクセス権を持つディスプレイ &ビデオ 360 ユーザーである必要があります。

ディスプレイ &ビデオ 360 のユーザーが次の操作を行うには、関連するパートナーまたは広告主に対して次のいずれかのユーザー役割を付与されている必要があります。

読み取り専用: get 呼び出しまたは list 呼び出しを使用してリソースを取得します（user リソースを除く）。
標準: リソースの取得、作成、更新。同じパートナーまたは広告主の権限を持つ user リソースを取得します。
管理: リソースの取得、作成、更新。管理するパートナーまたは広告主の user リソースを取得、作成、アクセス権を付与します。

API を使用して YouTube とパートナーのリソースを更新するにはどうすればよいですか？

Display & Video 360 API では、YouTube とパートナーのリソースの作成や更新はサポートされていません。YouTube とパートナーのリソースをまとめて作成または更新するには、ディスプレイ&ビデオ 360 のインターフェースで構造化データファイル（SDF）をアップロードします。SDF アップロードの詳しい使用方法については、YouTube とパートナーのリソースに関するガイドページをご覧ください。

地域をターゲットに設定する

地域ターゲティングは、次のターゲティングタイプを使用して広告申込情報に割り当てることができます。

TARGETING_TYPE_GEO_REGION
TARGETING_TYPE_POI
TARGETING_TYPE_BUSINESS_CHAIN
TARGETING_TYPE_REGIONAL_LOCATION_LIST
TARGETING_TYPE_PROXIMITY_LOCATION_LIST

targetingTypes.targetingOptions.search を使用して、最初の 3 つのターゲティングタイプのターゲティングオプション ID を取得します。advertisers.locationLists サービスを使用して、ロケーションリストリソースの取得と管理を行います。

さらに、TARGETING_TYPE_POI ターゲティングオプション ID を作成して、特定の緯度と経度の座標を中心とする近隣半径を直接ターゲットに設定することもできます。

API を使って構造化データファイル（SDF）をダウンロードすることはできますが、アップロードするにはどうすればよいですか？

Display & Video 360 API では、SDF のアップロードはサポートされていません。代わりに、API の CREATE、PATCH、DELETE メソッドでリソースを管理することをおすすめします。引き続き SDF を使用してリソースを管理する場合は、SDF ファイルをディスプレイ &ビデオ 360 のインターフェースで更新できます。

サポート

API に既知の問題や制限事項はありますか？

プロジェクトが 1 秒あたりに実行できるリクエストの数には上限があります。これについては、使用量上限のガイドをご覧ください。