API 工作流程

本指南說明如何透過 API 工作流程，在 Display & Video 360 中建立、擷取及更新競價組合。

取得拍賣套餐清單

呼叫 LIST API。支援依 external_deal_id 篩選。

創造新的拍賣包

  1. external_deal_id 必須是唯一的。使用 external_deal_id 呼叫 LIST，查看 ID 是否已使用。
  2. 呼叫 Create API。 系統會指派專屬名稱，可用於取得建立的套件。
  3. 呼叫 Get API，查看已建立競價套裝方案的詳細資料。
  4. (選用) 上傳為建立的套件使用的標誌。

更新競價套裝方案

  1. 如果您沒有儲存建立的拍賣包名稱，請呼叫按下 external_deal_id 篩選的 LIST API 以取得要更新的拍賣包。
  2. 根據 LIST API 的結果更新欄位。
  3. 呼叫 Patch API 來更新拍賣包。必須提供 updateMask。指出要套用更新的欄位。只有允許更新的欄位才能在updateMask中設定。

Beta 版程序

Beta 版和 GA 版之間的唯一區別在於，在 Beta 版期間，建立的拍賣包的狀態必須設定為 DISCOVERY_OBJECT_STATUS_PAUSED，且狀態無法更新。DV360 使用者介面不會顯示「已暫停」的套件。這為交易所提供了一種無需展示測試包即可測試 API 整合的方法。

一般做法是在 Beta 版中建立所有「實際」套裝組合，並設為「已暫停」，然後在正式版中啟用。

配額

每個交易所最多 2000 個有效套件。

每個廣告交易平台最多可暫停 2000 個套裝方案。

上一頁
總覽