版本資訊

Marketplace API

1.0 版本

日期 附註
2025 年 12 月 14 日
  • mediaPlanners 資源中的 accountID 欄位已淘汰。
2025 年 11 月 10 日
2025 年 8 月 26 日
2025 年 2 月 27 日
2024 年 12 月 9 日
2024 年 6 月 17 日
2024 年 6 月 6 日
2024 年 4 月 25 日
2024 年 4 月 23 日 已將 excludedSensitiveCategoryIds 指定值新增至 MarketplaceTargeting。已將 vertical_targeting 指定值新增至 MarketplaceTargeting。
2024 年 4 月 15 日
2024 年 3 月 7 日
2024 年 2 月 29 日
  • 在 Deal 中導入 mediaPlanner 欄位。
  • 在 Deal 中導入 eligibleSeatIds 欄位。
  • 如果交易屬於媒體企劃人員帳戶，系統不會填入交易的 billedBuyer。
2023 年 11 月 29 日 已將 AUDIO 列舉值新增至 CreativeFormat。已將 LG_TV 列舉值新增至 AppStoreType。
2021 年 10 月 11 日 Authorized Buyers Marketplace API 初次發布，可讓您：
  • 與發布商提案及協商交易
  • 擷取最終交易和交易健全程度指標
  • 管理競價套裝方案訂閱
  • 管理客戶和客戶使用者
  • 探索發布商簡介

1.0 版 Beta 版

日期 附註
2026 年 8 月 25 日
2026 年 7 月 20 日
2026 年 6 月 29 日
2025 年 12 月 14 日
  • 策展人現在可以在 v1beta 中使用 curatedPackages 和 mediaPlanners 資源。
  • mediaPlanners 資源中的 accountID 欄位已淘汰。
2025 年 6 月 11 日
  • v1beta API 的初始版本。
  • dataSegments 資源現已在 v1beta 中提供。
    • dataSegments 的資源路徑已從 v1alpha 的 buyers/{accountId}/dataSegments 變更為 v1beta 的 curators/{accountId}/dataSegments。

1.0 alpha 版

日期 附註
2026 年 8 月 25 日
2026 年 7 月 20 日
2026 年 6 月 29 日
2025 年 12 月 14 日
  • 策展人現在可以在 v1alpha 中使用 curatedPackages 和 mediaPlanners 資源。
  • mediaPlanners 資源中的 accountID 欄位已淘汰。
2024 年 6 月 12 日
  • 第 1 版 Alpha 版 API 的初始版本。

Real-time Bidding API

1.0 版本

日期 附註
2026 年 9 月 20 日 由於政策更新，賭博和社交類賭場遊戲不再需要認證，因此已淘汰 CERTIFICATE_REQUIRED狀態和 missingCertificate欄位。
2026 年 9 月 10 日 在 buyers.creatives 資源中導入 addDeals 方法，讓買方將交易 ID (包括程式輔助保證、私下競價、首選交易和市集套裝方案) 與廣告素材建立關聯。
2026 年 7 月 9 日 已淘汰 PretargetingConfig 中的 allowed_user_targeting_modes 欄位和 UserTargetingMode 列舉。
2025 年 5 月 1 日 從 BidProtocol 列舉空間中移除已淘汰的值 GOOGLE_RTB。
2025 年 2 月 24 日 在 AdCategoryTaxonomy 列舉空間中新增值 GOOGLE_AD_CATEGORY_TAXONOMY。
2025 年 2 月 13 日 已淘汰「廣告素材」中聲明的受限類別。
2024 年 8 月 6 日
2024 年 7 月 30 日
2023 年 10 月 31 日 buyers.userLists.getRemarketingTag 和 UrlRestriction 已淘汰，如果呼叫，會傳回錯誤回應。建議您使用 Cookie 比對代碼的google_ula功能，從瀏覽器安插代碼，將使用者新增至使用者名單。詳情請參閱 Cookie 比對說明文件。
2023 年 10 月 12 日 已將 RENDERING_PLAYABLE 列舉值新增至 CreativeAttribute。
2023 年 8 月 17 日 buyers.userLists.getRemarketingTag 和 UrlRestriction 已淘汰，並將於 2023 年 10 月 31 日停用。使用 Cookie 比對代碼的 google_ula 功能，從瀏覽器安插代碼，將使用者加入使用者名單。詳情請參閱 Cookie 比對說明文件。
2023 年 3 月 17 日 在 PolicyTopicEntry 中新增 missingCertificate 欄位。
2023 年 2 月 7 日

從 bidders.endpoints.bidProtocol 中移除下列已淘汰的列舉值：

  • OPENRTB_2_2
  • OPENRTB_2_3
  • OPENRTB_PROTOBUF_2_3
  • OPENRTB_2_4
  • OPENRTB_PROTOBUF_2_4
  • OPENRTB_2_5
  • OPENRTB_PROTOBUF_2_5
2022 年 11 月 8 日

新增 OPENRTB_PROTOBUF 列舉值，適用於 bidders.endpoints.bidProtocol。今後，系統一次只會支援一個 OpenRTB 版本。您應使用 OPENRTB_JSON 或 OpenRTB_PROTOBUF，以偏好的格式使用最新支援的 OpenRTB 版本。詳情請參閱這篇部落格文章，瞭解我們為何要停止支援舊版 OpenRTB。

下列 bidders.endpoints.bidProtocol 列舉欄位已標示為已淘汰：

  • OPENRTB_2_2
  • OPENRTB_2_3
  • OPENRTB_PROTOBUF_2_3
  • OPENRTB_2_4
  • OPENRTB_PROTOBUF_2_4
  • OPENRTB_2_5
  • OPENRTB_PROTOBUF_2_5
2022 年 9 月 20 日 推出實驗性 creatives.renderUrl 欄位，供 FLEDGE 來源試用。
2022 年 9 月 1 日 部分廣告素材已推出「 CERTIFICATE_REQUIRED」狀態。詳情請參閱賭博和遊戲政策。
2022 年 4 月 27 日 發布 publisherConnections 資源。公開出價交易所可使用 publisherConnections 管理與發布商的連線。
2021 年 11 月 1 日 推出 bidders.enpoints.patch，可更新出價工具的端點。
2021 年 5 月 27 日 在原生廣告素材資源中導入 oneof 欄位 video，可接受 videoVastXml 或 videoUrl。
2020 年 10 月 8 日 已將欄位 openAuctionServingStatus、openBiddingServingStatus、dealsServingStatus、chinaServingStatus 和 russiaServingStatus 分別替換為 networkPolicyCompliance、platformPolicyCompliance、dealsPolicyCompliance、chinaPolicyCompliance 和 russiaPolicyCompliance。
2020 年 6 月 24 日 即時出價 API 初次推出，最終將取代 Ad Exchange Buyer 和 Ad Exchange Buyer II API。

舊版

2.0 版 (已淘汰)

日期 附註
2025 年 8 月 11 日

在 NonBillableWinningBidStatusRow 的 Status 列舉中新增 OVERDELIVERED_IMPRESSION 狀態。

2023 年 9 月 29 日

除了用於 RTB 疑難排解的資源外，所有其他資源都已淘汰，如果呼叫這些資源，系統會傳回錯誤回應。建議改用 Marketplace API，繼續以程式輔助方式存取 Marketplace 方案。淘汰資源包括下列項目和所有子資源：

  • accounts.clients
  • accounts.creatives
  • accounts.finalizedProposals
  • accounts.products
  • accounts.proposals
  • accounts.publisherProfiles
  • accounts.clients
2021/5/24

新增交易層級的 pause 和 resume 方法。
2020/8/20

在 BidMetricsRow 中加入 detail 欄位。
2020/5/6

在 BidMetricsRow 中加入 reachedQueries 欄位。在 NonBillableWinningBidStatusRow 的 Status 列舉中新增 FATAL_VAST_ERROR 和 LOST_IN_MEDIATION。
2016 年 3 月 9 日

發布 用戶端存取權 公開測試版。 您現在可以讓買方客戶直接存取 Authorized Buyers 市集，查看、協議及核准交易。此外，您的應用程式可以透過程式輔助執行作業，這些作業先前必須在 Authorized Buyers 的「買方帳戶設定」分頁「客戶」部分手動完成。