Release Notes

  • The Marketplace API version 1.0 includes updates such as allowing only PIXEL inventory sizes for targeting in sendRfp calls, introducing new fields like buyerPermissionType and dealOwnerSeatId, fixing a bug with adding notes to Private Auction Proposals, and adding support for pausing and resuming Preferred deals.

  • Recent updates to the Marketplace API version 1.0 also include support for the orderBy parameter in auction package listings, adding targeting values like excludedSensitiveCategoryIds and vertical_targeting, and introducing methods and fields for listing and subscribing to auction packages at the bidder and buyer levels.

  • The Real-time Bidding API version 1.0 has deprecated the GOOGLE_RTB bid protocol value, added a new ad category taxonomy value, deprecated declared restricted categories in Creative, introduced fields for creative serving decisions, added a new publisher first-party ID value to PretargetingConfig, and sunset buyers.userLists.getRemarketingTag and UrlRestriction.

  • Legacy Ad Exchange Buyer API II is deprecated, with most resources sunset as of September 29th, 2023, and users are recommended to migrate to the Marketplace API, although some resources remain for RTB Troubleshooting.

Marketplace API

Version 1.0

Date Notes
August 26th, 2025
Feb 27th, 2025
Dec 9th, 2024
June 17th, 2024
June 6, 2024
April 25th, 2024
April 23rd, 2024 Added the excludedSensitiveCategoryIds targeting value to MarketplaceTargeting. Added the vertical_targeting targeting value to MarketplaceTargeting.
April 15th, 2024
March 7th, 2024
February 29th, 2024
  • Introduced the mediaPlanner field to Deal.
  • Introduced the eligibleSeatIds field to Deal.
  • Deal's billedBuyer will not be populated if it belongs to a media planner account.
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

Version 1.0 beta

Date Notes
June 11th, 2025
  • Initial release of the v1beta API.
  • The dataSegments resource is now available in v1beta.
    • The resource path for dataSegments has changed from buyers/{accountId}/dataSegments in v1alpha to curators/{accountId}/dataSegments in v1beta

Version 1.0 alpha

Date Notes
June 12th, 2024
  • Initial release of the v1alpha API.

Real-time Bidding API

Version 1.0

Date Notes
May 1st, 2025 Deprecated value GOOGLE_RTB from the BidProtocol enum space.
Feb 24th, 2025 Added new value GOOGLE_AD_CATEGORY_TAXONOMY to the AdCategoryTaxonomy enum space.
Feb 13th, 2025 Deprecated declared restricted categories in Creative.
August 6th, 2024
July 30th, 2024
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
8/11/2025

Added the OVERDELIVERED_IMPRESSION status to the Status enum of NonBillableWinningBidStatusRow.

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.