2025 年 9 月 8 日以降、すべての新しい広告申込情報で、欧州連合（EU）の政治広告を配信するかどうかを宣言する必要があります。宣言が提供されていないディスプレイ＆ビデオ 360 API と SDF のアップロードは失敗します。統合を更新してこの宣言を行う方法について詳しくは、
非推奨のページをご覧ください。
よくある質問
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
全般
API の最新バージョンは何ですか？
このドキュメントで説明する API の最新バージョンは v4 です。
いいえ。ディスプレイ＆ビデオ 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_REGIONTARGETING_TYPE_POITARGETING_TYPE_BUSINESS_CHAINTARGETING_TYPE_REGIONAL_LOCATION_LISTTARGETING_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 秒あたりに実行できるリクエスト数には上限があります。詳しくは、使用上限ガイドをご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[[["\u003cp\u003eThe Display & Video 360 API v3 allows programmatic access to resources like advertisers, campaigns, and line items, but not performance data.\u003c/p\u003e\n"],["\u003cp\u003eOAuth 2.0 is the required authentication method, using specific scopes for Display & Video 360 and user management.\u003c/p\u003e\n"],["\u003cp\u003eWhile client libraries are recommended, direct HTTP requests can be used; however, some methods might be more complex to implement.\u003c/p\u003e\n"],["\u003cp\u003eUser roles (Read Only, Standard, Admin) dictate API access levels for retrieving, creating, and updating resources.\u003c/p\u003e\n"],["\u003cp\u003eGeographic targeting can be applied using various targeting types, including geo regions, POIs, and custom location lists.\u003c/p\u003e\n"]]],[],null,["# Frequently Asked Questions\n\nGeneral\n-------\n\n### What's the latest version of the API?\n\nThe latest version of the API that this document addresses is\n`v4`.\n\n### Can I retrieve performance data using this API?\n\nNo. Use the [Bid Manager API](/bid-manager/guides/getting-started-api) to create, retrieve, and run\nDisplay \\& Video 360 offline reports.\n\nUse the API\n-----------\n\n### What URL do I use to access the API?\n\n`https://displayvideo.googleapis.com`\n\n### What methods of authentication are supported?\n\nOAuth 2.0 is the only supported method of authentication.\n\nDisplay \\& Video 360 API requests must be authorized for the following scope:\n\n- `https://www.googleapis.com/auth/display-video`\n\nRequests to the [`users`](/display-video/api/reference/rest/current/users) service must also be authorized for the\nfollowing additional scope:\n\n- `https://www.googleapis.com/auth/display-video-user-management`\n\n### I want to write code. Where can I find client libraries?\n\nRefer to the [client library](/display-video/api/guides/getting-started/libraries) guide.\n\n### What if I don't want to use a client library?\n\nWe recommend that you use one of our client libraries but you can also interact\nwith the Display \\& Video 360 API using direct HTTP requests.\n\nSome more involved methods, such as [`advertisers.assets.upload`](/display-video/api/reference/rest/current/advertisers.assets/upload)\nand [`media.upload`](/display-video/api/reference/rest/current/media/upload), are harder to translate directly to HTTP\nrequests. See examples of HTTP requests to these methods using cURL on our\n[Creative](/display-video/api/guides/creating-creatives/overview#upload_an_asset) and [Custom Bidding](/display-video/api/guides/managing-line-items/custom-bidding#upload_a_script_file) guides.\n\n### What Display \\& Video 360 permissions do I need?\n\nIn order to use the Display \\& Video 360 API, the authenticating Google Account must be a\nDisplay \\& Video 360 user with access to relevant partners or advertisers.\n\nThe Display \\& Video 360 user must have one of the following [user\nroles](//support.google.com/displayvideo/answer/2723011) for the relevant partners or advertisers to do the\nfollowing actions:\n\n- **Read only** : Retrieve resources using `get` or `list` calls, excluding `user` resources.\n- **Standard** : Retrieve, create, and update resources. Retrieve `user` resources with permissions to the same partners or advertisers.\n- **Admin** : Retrieve, create, and update resources. Retrieve, create and grant access to `user` resources for the partners or advertisers you administrate.\n\n### How do I update YouTube \\& Partners resources using the API?\n\nThe Display \\& Video 360 API does not support creating or updating YouTube \\& Partners\nresources. Create or update YouTube \\& Partners resources in bulk by uploading\nStructured Data Files (SDF) in the [Display \\& Video 360 interface](//displayvideo.google.com/). For\nmore details on how to use SDF upload, read our [guide page](/display-video/api/guides/managing-line-items/youtube#create_and_update_using_sdf_ui_upload) about\nYouTube \\& Partners resources.\n\n### How do I target geographic locations?\n\nGeographic targeting can be assigned to line items using the following targeting\ntypes:\n\n- `TARGETING_TYPE_GEO_REGION`\n- `TARGETING_TYPE_POI`\n- `TARGETING_TYPE_BUSINESS_CHAIN`\n- `TARGETING_TYPE_REGIONAL_LOCATION_LIST`\n- `TARGETING_TYPE_PROXIMITY_LOCATION_LIST`\n\nRetrieve targeting option IDs for the first three targeting types using\n[`targetingTypes.targetingOptions.search`](/display-video/api/reference/rest/current/targetingTypes.targetingOptions/search). Retrieve and manage\nlocation list resources using the [`advertisers.locationLists`](/display-video/api/reference/rest/current/advertisers.locationLists)\nservice.\n\nIn addition, you can also [build a `TARGETING_TYPE_POI` targeting option\nID](/display-video/api/guides/managing-line-items/targeting#build_poi_targeting_option_ids) to directly target a proximity radius around\nspecific latitude-longitude coordinates.\n\n### I see that I can download Structured Data Files (SDFs) using the API, but how do I upload them?\n\nThe Display \\& Video 360 API does not support SDF upload. We recommend [managing\nresources](/display-video/api/guides/managing-line-items/resources) through `CREATE`, `PATCH`, and `DELETE` methods\nprovided by the API instead. If you still want to manage resources using SDFs,\nthose files can be updated in the [Display \\& Video 360 interface](//displayvideo.google.com/).\n\nSupport\n-------\n\n### Does the API have any known issues or limitations?\n\nThere are limits on the number of requests your project can make per second,\nwhich are outlined in our [usage limits guide](/display-video/api/limits)."]]
