版本说明

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 日 向 MarketplaceTargeting 添加了 excludedSensitiveCategoryIds 定位值。向 MarketplaceTargeting 添加了 vertical_targeting 定位值。
2024 年 4 月 15 日
2024 年 3 月 7 日
2024 年 2 月 29 日
  • 在 Deal 中引入了 mediaPlanner 字段。
  • 在 Deal 中引入了 eligibleSeatIds 字段。
  • 如果交易属于媒体策划人员账号，则不会填充交易的 billedBuyer。
2023 年 11 月 29 日 向 CreativeFormat 添加了 AUDIO 枚举值。向 AppStoreType 添加了 LG_TV 枚举值。
2021 年 10 月 11 日 首次发布 Authorized Buyers Marketplace API，该 API 可让您：
  • 与发布商协商并提出交易
  • 检索最终确定的交易和交易健康状况指标
  • 管理竞价包订阅
  • 管理客户和客户用户
  • 发现发布商资料

版本 1.0 Beta 版

日期 备注
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 年 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 日 已弃用 广告素材中声明的受限类别。
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 日 首次发布 实时出价 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 日

以公开 Beta 版的形式发布了客户端访问。 现在，您可以让买方客户直接访问 Authorized Buyers 市场，以便查看、协商和批准交易。 此外，您的应用还可以通过编程方式执行之前必须在 Authorized Buyers 的买方账号设置标签页的客户部分中手动完成的操作。