よくある質問

全般

API の最新バージョンは何ですか？

このドキュメントで説明する API の最新バージョンは v4 です。

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

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

API を使用する

API にアクセスする URL は何ですか？

https://displayvideo.googleapis.com

サポートされている認証方法

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

ディスプレイ＆ビデオ 360 API リクエストは、次のスコープで承認されている必要があります。

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

users サービスへのリクエストには、次の追加スコープの承認も必要です。

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

コードを記述したい。クライアント ライブラリはどこで入手できますか？

クライアント ライブラリ ガイドを参照してください。

クライアント ライブラリを使用したくない場合はどうすればよいですか？

いずれかのクライアント ライブラリを使用することをおすすめしますが、直接 HTTP リクエストを使用してディスプレイ＆ビデオ 360 API を操作することもできます。

advertisers.assets.upload や media.upload など、より複雑なメソッドは、HTTP リクエストに直接変換するのが難しい場合があります。cURL を使用してこれらのメソッドに送信する HTTP リクエストの例については、クリエイティブとカスタム入札のガイドをご覧ください。

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

ディスプレイ＆ビデオ 360 API を使用するには、認証を行う Google アカウントが、関連するパートナーまたは広告主にアクセスできるディスプレイ＆ビデオ 360 ユーザーである必要があります。

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

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

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

Display & Video 360 API では、YouTube とパートナーのリソースの作成と更新はサポートされていません。ディスプレイ＆ビデオ 360 の管理画面で構造化データファイル（SDF）をアップロードして、YouTube とパートナーのリソースを一括で作成または更新します。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 を使用してリソースを管理する場合は、ディスプレイ＆ビデオ 360 の管理画面でファイルを更新できます。

サポート

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

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