自
2025 年 9 月 8 日起，每個新委刊項都必須聲明是否會放送歐盟政治廣告。如果透過 Display & Video 360 API 和 SDF 上傳的檔案未提供聲明，系統就會失敗。如要進一步瞭解如何更新整合服務以進行這項聲明，請參閱
淘汰項目頁面。
常見問題
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
一般
最新版 API 是哪個版本？
本文件所述的 API 最新版本為 v4。
否。請使用 Bid Manager API 建立、擷取及執行 Display & Video 360 離線報表。
使用 API
我該使用哪個網址存取 API？
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
我想編寫程式碼。哪裡可以找到用戶端程式庫？
請參閱用戶端程式庫指南。
如果我不想使用用戶端程式庫，該怎麼辦？
我們建議您使用其中一種用戶端程式庫，但您也可以使用直接的 HTTP 要求與 Display & Video 360 API 互動。
有些較複雜的方法，例如 advertisers.assets.upload 和 media.upload，較難直接轉譯為 HTTP 要求。請參閱廣告素材和自訂出價指南，瞭解如何使用 cURL 向這些方法提出 HTTP 要求。
我需要哪些 Display & Video 360 權限？
如要使用 Display & Video 360 API，驗證的 Google 帳戶必須是 Display & Video 360 使用者，且能存取相關合作夥伴或廣告客戶。
Display & Video 360 使用者必須具備下列任一使用者角色，才能讓相關合作夥伴或廣告主執行下列操作：
- 唯讀：使用
get 或 list 呼叫擷取資源，但不包括 user 資源。
- 標準：擷取、建立及更新資源。擷取具有相同合作夥伴或廣告主權限的
user 資源。
- 管理：擷取、建立及更新資源。針對您管理的合作夥伴或廣告主，擷取、建立及授予
user 資源存取權。
如何使用 API 更新 YouTube 與合作夥伴資源？
Display & Video 360 API 不支援建立或更新 YouTube 與合作夥伴資源。在 Display & Video 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 擷取前三種指定類型的指定選項 ID。使用 advertisers.locationLists 服務擷取及管理位置清單資源。
此外，您也可以建立 TARGETING_TYPE_POI 指定目標選項 ID，直接指定特定經緯度座標周圍的鄰近半徑。
我知道可以使用 API 下載結構化資料檔案 (SDF)，但如何上傳這些檔案？
Display & Video 360 API 不支援上傳結構化資料檔案。建議您改為透過 API 提供的 CREATE、PATCH 和 DELETE 方法管理資源。如果您仍想使用 SDF 管理資源，可以透過 Display & Video 360 介面更新這些檔案。
支援
API 是否有任何已知問題或限制？
專案每秒可發出的要求數量有限制，詳情請參閱用量限制指南。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-25 (世界標準時間)。
[null,null,["上次更新時間：2025-07-25 (世界標準時間)。"],[[["\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)."]]
