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