Release Notes

Marketplace API

Version 1.0

Date	Notes
June 17th, 2024	Fixed a bug where `buyers.proposals.addNote` could be used for Private Auction Proposals, which is not a valid workflow because this deal type does not involve negotiation.
June 6, 2024	Added support for `pausing` and `resuming` Preferred deals.
April 25th, 2024	Support for the `orderBy` parameter has been added to `bidders.auctionPackages.list`.
April 23rd, 2024	Added the excludedSensitiveCategoryIds targeting value to `MarketplaceTargeting`. Added the vertical_targeting targeting value to `MarketplaceTargeting`.
April 15th, 2024	Introduced `bidders.auctionPackages.list` to list auction packages at the bidder level. Auction packages returned by this method list media planners that are subscribed to it with the `subscribedMediaPlanners` field. Introduced the subscribedBuyers field to `AuctionPackage`. Introduced the subscribedMediaPlanners field to `AuctionPackage`. Introduced the eligibleSeatIds field to `AuctionPackage`.
March 7th, 2024	Introduced the PUBLISHER_PROVIDED_ID enumeration value to `PretargetingConfig`.
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 alpha

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

Real-time Bidding API

Version 1.0

Date	Notes
August 6th, 2024	Introduced the `detectedCategoriesTaxonomy` and `detectedCategories` fields to CreativeServingDecision.
July 30th, 2024	Introduced the PUBLISHER_FIRST_PARTY_ID enumeration value to `PretargetingConfig`.
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.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2024-09-18 UTC.