常見問題

一般

最新版 API 是哪個版本？

本文件所述的 API 最新版本為 v4。

我可以使用這個 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 要求。請參閱廣告素材和自訂出價指南，瞭解如何使用 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_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 不支援上傳結構化資料檔案。建議您改為透過 API 提供的 CREATE、PATCH 和 DELETE 方法管理資源。如果您仍想使用 SDF 管理資源，可以透過 Display & Video 360 介面更新這些檔案。

支援

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

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