よくある質問

一般

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 秒あたりに実行できるリクエストの数には上限があります。これについては、使用量上限のガイドをご覧ください。