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

Ad Exchange Buyer API II is deprecated. With the exception of resources used for RTB Troubleshooting, all others have sunset as of September 29th, 2023. If you need to continue using Marketplace, we recommend migrating to the Marketplace API.

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.