版本資訊

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。在 AppStoreType 中新增 LG_TV 列舉值。
2021 年 10 月 11 日 Authorized Buyers Marketplace API 首次推出，可讓您：
  • 向發布商提案及協商交易
  • 擷取已完成的交易和交易健康指標
  • 管理競價套裝方案訂閱
  • 管理客戶和客戶使用者
  • 探索發布商簡介

1.0 Beta 版

日期 附註
2026 年 10 月 19 日
2026 年 8 月 25 日
2026 年 7 月 20 日
2026 年 6 月 29 日
2025 年 12 月 14 日
  • curatedPackages 和 mediaPlanners 資源現已在 v1beta 中開放給管理員使用。
  • mediaPlanners 資源中的 accountID 欄位已淘汰。
2025 年 6 月 11 日
  • v1beta API 的初始版本。
  • dataSegments 資源現已在 v1beta 中推出。
    • dataSegments 的資源路徑已從 v1alpha 中的 buyers/{accountId}/dataSegments 變更為 v1beta 中的 curators/{accountId}/dataSegments

1.0 Alpha 版

日期 附註
2026 年 10 月 19 日
2026 年 8 月 25 日
2026 年 7 月 20 日
2026 年 6 月 29 日
2025 年 12 月 14 日
  • curatedPackages 和 mediaPlanners 資源現已開放給 v1alpha 的管理員使用。
  • mediaPlanners 資源中的 accountID 欄位已淘汰。
2024 年 6 月 12 日
  • v1alpha 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 日 已淘汰 Creative 中宣告的受限制的類別。
2024 年 8 月 6 日
2024 年 7 月 30 日
2023 年 10 月 31 日 buyers.userLists.getRemarketingTag 和 UrlRestriction 已停用，如果呼叫，會傳回錯誤回應。建議您使用 Cookie 比對標記的 google_ula 功能，透過瀏覽器放置標記，將使用者加入使用者名單。詳情請參閱 Cookie 比對說明文件
2023 年 10 月 12 日 在 CreativeAttribute 中新增 RENDERING_PLAYABLE 列舉值。
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 日

為 bidders.endpoints.bidProtocol 新增 OPENRTB_PROTOBUF 列舉值。日後，我們一次只會支援一個 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 日 針對 FLEDGE 來源試用，推出實驗性 creatives.renderUrl 欄位。
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 日 Real-time Bidding API 首次推出，最終將取代 Ad Exchange Buyer 和 Ad Exchange Buyer II API。

舊版

2.0 版 (已淘汰)

日期 附註
2025/8/11

在 NonBillableWinningBidStatusRow 的 Status 列舉中新增 OVERDELIVERED_IMPRESSION 狀態。
2023/9/29

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

  • 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「買方帳戶設定」分頁的「客戶」部分中手動完成。