Release Notes

Marketplace API

Version 1.0

Date Notes
November 29th, 2023 Added the AUDIO enum value to CreativeFormat. Added the LG_TV enum value to AppStoreType.
October 11, 2021 Initial launch of the Authorized Buyers Marketplace API, which lets you:
  • Propose and negotiate deals with publishers
  • Retrieve finalized deals and deal health metrics
  • Manage auction package subscriptions
  • Manage clients and client users
  • Discover publisher profiles

Real-time Bidding API

Version 1.0

Date Notes
October 31st, 2023 buyers.userLists.getRemarketingTag and UrlRestriction has been sunset, and will return an error response if called. We recommend using Cookie Matching tag's google_ula feature to add users to user list by placing a tag from the browsers. See more in Cookie Matching documentation
October 12st, 2023 Added the RENDERING_PLAYABLE enum value to CreativeAttribute.
August 17th, 2023 buyers.userLists.getRemarketingTag and UrlRestriction are deprecated and will be sunset on 2023/10/31. Use Cookie Matching tag's google_ula feature to add users to user list by placing a tag from the browsers. See more in Cookie Matching documentation
March 17th, 2023 Added the missingCertificate field to PolicyTopicEntry.
February 7, 2023

Removed the following deprecated enum values from 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
November 8, 2022

Added new OPENRTB_PROTOBUF enum value for bidders.endpoints.bidProtocol. Going forward, only one OpenRTB version will be supported at a time. You should use OPENRTB_JSON or OpenRTB_PROTOBUF to use the latest supported version of OpenRTB in your preferred format. See our blog post about Removing support for old OpenRTB versions for more details.

The following enum fields from bidders.endpoints.bidProtocol have been marked deprecated:

  • OPENRTB_2_2
  • OPENRTB_2_3
  • OPENRTB_PROTOBUF_2_3
  • OPENRTB_2_4
  • OPENRTB_PROTOBUF_2_4
  • OPENRTB_2_5
  • OPENRTB_PROTOBUF_2_5
September 20, 2022 Introduced experimental creatives.renderUrl field for FLEDGE origin trials.
September 1, 2022 Introduced the CERTIFICATE_REQUIRED status for some creatives. See Gambling and games policy for more information.
April 27, 2022 Release of the publisherConnections resource. Open Bidding exchanges can use publisherConnections to manage connections with publishers.
Nov 1, 2021 Introduced bidders.enpoints.patch to update a bidder's endpoint.
May 27, 2021 Introduced oneof field video to the Native Creatives resource, which accepts either videoVastXml or videoUrl.
October 8, 2020 Replaced fields openAuctionServingStatus, openBiddingServingStatus, dealsServingStatus, chinaServingStatus and russiaServingStatus with networkPolicyCompliance, platformPolicyCompliance, dealsPolicyCompliance, chinaPolicyCompliance and russiaPolicyCompliance respectively.
June 24, 2020 Initial launch of the Real-time Bidding API, to eventually replace the Ad Exchange Buyer and Ad Exchange Buyer II APIs.

Legacy

Version 2.0 (Deprecated)

Date Notes
9/29/2023

All resources other than those used for RTB Troubleshooting have been sunset, and will return an error response if called. We recommend migrating to Marketplace API in order to continue accessing Marketplace programmatically. Sunset resources include the following and all of their sub-resources:

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

Added deal-level pause and resume methods.

8/20/2020

Added the detail field to BidMetricsRow.

5/6/2020

Added the reachedQueries field to BidMetricsRow. Added FATAL_VAST_ERROR and LOST_IN_MEDIATION to the Status enum of NonBillableWinningBidStatusRow.

3/9/2016

Released Client Access as an open beta. You can now let your client buyers directly access the Authorized Buyers Marketplace to be able to view, negotiate, and approve deals. And, your application can programmatically perform operations that previously had to be done manually in the Clients section of the Authorized Buyers Buyer Account Settings tab.