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 個套裝方案。