常見問題

一般

API 的最新版本為何？

這份文件所處理的最新版 API 為 v3。

我可以使用這個 API 擷取效能資料嗎？

不需要。請使用 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 要求。如要查看對這些方法發出的 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_REGION
• TARGETING_TYPE_POI
• TARGETING_TYPE_BUSINESS_CHAIN
• TARGETING_TYPE_REGIONAL_LOCATION_LIST
• TARGETING_TYPE_PROXIMITY_LOCATION_LIST

使用 targetingTypes.targetingOptions.search 擷取前三種指定類型的指定目標選項 ID。使用 advertisers.locationLists 服務擷取及管理位置清單資源。

此外，您也可以建構 TARGETING_TYPE_POI 指定選項 ID，直接指定以特定經緯度座標為中心的鄰近半徑範圍。

我發現可以使用 API 下載結構化資料檔案 (SDF)，但該如何上傳？

Display & Video 360 API 不支援上傳 SDF。建議您改用 API 提供的 CREATE、PATCH 和 DELETE 方法管理資源。如果您還是想使用 SDF 管理資源，可以在 Display & Video 360 介面中更新這些檔案。

支援

這個 API 是否有任何已知問題或限制？

對於專案每秒可發出的要求數量設有限制，詳情請參閱用量限制指南。