API 工作流程

取得競價套裝方案清單

呼叫 LIST API。支援依 external_deal_id 篩選

建立新的競價套裝方案

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

更新競價套裝方案

  1. 如果沒有儲存建立的競價套件名稱,請呼叫 LIST API,依 external_deal_id 篩選,取得要更新的競價套件。
  2. 根據 LIST API 的結果更新欄位。
  3. 呼叫 Patch API 更新競價套裝方案。「updateMask」為必填欄位,表示要將更新套用至哪些欄位。「updateMask」中只能設定允許更新的欄位。

Beta 版程序

Beta 版與正式版唯一的差異在於,在 Beta 版中建立的競價組合狀態必須設為「DISCOVERY_OBJECT_STATUS_PAUSED」,且無法更新狀態。DV3 UI 不會顯示「已暫停」的套件。這樣一來,交易所就能測試 API 整合,而不必顯示測試套件。

一般來說,您會在 Beta 版中建立所有「實際」套裝組合,並將其設為「已暫停」,然後在正式發布後「啟用」這些套裝組合。

配額

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

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