版本資訊

Marketplace API

1.0 版本

日期 附註
2025 年 8 月 26 日
2025 年 2 月 27 日
2024 年 12 月 9 日
2024 年 6 月 17 日
2024 年 6 月 6 日
2024 年 4 月 25 日
2024 年 4 月 23 日 已將 excludedSensitiveCategoryIds 指定值新增至 MarketplaceTargeting。已將 MarketplaceTargeting 的指定目標值新增至 vertical_targeting。
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 版

日期 附註
2025 年 6 月 11 日
  • v1beta API 初始版本。
  • dataSegments 資源現已在 v1beta 中提供。
    • dataSegments 的資源路徑已從 v1alpha 中的 buyers/{accountId}/dataSegments 變更為 v1beta 中的 curators/{accountId}/dataSegments

1.0 alpha 版

日期 附註
2024 年 6 月 12 日
  • v1alpha API 的初始版本。

Real-time Bidding API

1.0 版本

日期 附註
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 版本。詳情請參閱這篇網誌文章。

下列 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 日 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，以便繼續以程式輔助方式存取 Marketplace。淘汰資源包括下列項目和所有子資源：

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

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

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

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

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