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
    December 14, 2025
    • The accountID field in the mediaPlanners resource has been deprecated.
    November 10th, 2025
    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
    December 14, 2025
    • The curatedPackages and mediaPlanners resources are now available for curators in v1beta.
    • The accountID field in the mediaPlanners resource has been deprecated.
    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
    December 14, 2025
    • The curatedPackages and mediaPlanners resources are now available for curators in v1alpha.
    • The accountID field in the mediaPlanners resource has been deprecated.
    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.
    Design a Mobile Site
    View Site in Mobile | Classic
    Share by: