API 工作流程
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
取得競價套裝方案清單
呼叫 LIST API。支援依 external_deal_id 篩選
建立新的競價套裝方案
- external_deal_id 不得重複。使用 external_deal_id 呼叫 LIST,確認該 ID 是否已使用。
- 呼叫「Create API」。系統會指派專屬名稱,可用於取得建立的套件。
- 呼叫「Get API」,查看已建立競價套裝方案的詳細資料。
- (選用) 為建立的套件上傳標誌。
更新競價套裝方案
- 如果沒有儲存建立的競價套件名稱,請呼叫 LIST API,依 external_deal_id 篩選,取得要更新的競價套件。
- 根據 LIST API 的結果更新欄位。
- 呼叫 Patch API 更新競價套裝方案。「updateMask」為必填欄位,表示要將更新套用至哪些欄位。「updateMask」中只能設定允許更新的欄位。
Beta 版程序
Beta 版與正式版唯一的差異在於,在 Beta 版中建立的競價組合狀態必須設為「DISCOVERY_OBJECT_STATUS_PAUSED」,且無法更新狀態。DV3 UI 不會顯示「已暫停」的套件。這樣一來,交易所就能測試 API 整合,而不必顯示測試套件。
一般來說,您會在 Beta 版中建立所有「實際」套裝組合,並將其設為「已暫停」,然後在正式發布後「啟用」這些套裝組合。
配額
每個交易所最多 2000 個有效套件。
每個廣告交易平台最多可暫停 2000 個套裝方案。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-10-08 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-10-08 (世界標準時間)。"],[],["Auction package management involves listing, creating, and updating. To list packages, use the LIST API, filtering by `external_deal_id`. Creation requires a unique `external_deal_id` and uses the Create API; retrieve package details with the Get API. Updating involves using the LIST API to retrieve the package, modifying fields, and using the Patch API with an `updateMask`. During beta, created packages must be \"PAUSED\" and cannot have their status changed. Each exchange has a quota of 1000 active and 1000 paused packages.\n"]]