## Marketplace API

### Version 1.0

| Date | Notes |
|---|---|
| December 14, 2025 | - The `accountID` field in the `mediaPlanners` resource has been deprecated. |
| November 10th, 2025 | - Introduced the [`floorPriceCpm`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.auctionPackages.md.txt#AuctionPackage.FIELDS.floor_price_cpm) field to `AuctionPackage`. - Added bidder-level support for [`setReadyToServe`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1/bidders.finalizedDeals/setReadyToServe.md.txt). |
| August 26th, 2025 | - Only PIXEL inventory sizes are allowed for inventory size targeting when calling [buyers.proposals.sendRfp](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.proposals/sendRfp.md.txt). |
| Feb 27th, 2025 | - Introduced the [`buyerPermissionType`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.proposals.deals.md.txt#Deal.FIELDS.buyer_permission_type) field to `Deal`. |
| Dec 9th, 2024 | - Introduced the [`dealOwnerSeatId`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.auctionPackages.md.txt#AuctionPackage.FIELDS.deal_owner_seat_id) field to `AuctionPackage`. |
| June 17th, 2024 | - [Fixed a bug where `buyers.proposals.addNote`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.proposals/addNote.md.txt) 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`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.finalizedDeals/pause.md.txt) and [`resuming`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.finalizedDeals/resume.md.txt) Preferred deals. |
| April 25th, 2024 | - Support for the `orderBy` parameter has been added to [`bidders.auctionPackages.list`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1/bidders.auctionPackages/list.md.txt). |
| April 23rd, 2024 | Added the [`excludedSensitiveCategoryIds`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.proposals.deals.md.txt#Deal.MarketplaceTargeting.FIELDS.excluded_sensitive_category_ids) targeting value to `MarketplaceTargeting`. Added the [`vertical_targeting`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.proposals.deals.md.txt#Deal.MarketplaceTargeting.FIELDS.vertical_targeting) targeting value to `MarketplaceTargeting`. |
| April 15th, 2024 | - Introduced [`bidders.auctionPackages.list`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.auctionPackages/list.md.txt) 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`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.auctionPackages.md.txt#AuctionPackage.FIELDS.subscribed_buyers) field to `AuctionPackage`. - Introduced the [`subscribedMediaPlanners`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.auctionPackages.md.txt#AuctionPackage.FIELDS.subscribed_media_planners) field to `AuctionPackage`. - Introduced the [`eligibleSeatIds`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.auctionPackages.md.txt#AuctionPackage.FIELDS.eligible_seat_ids) field to `AuctionPackage`. |
| March 7th, 2024 | - Introduced the [`PUBLISHER_PROVIDED_ID`](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.pretargetingConfigs.md.txt#UserIdType.ENUM_VALUES.PUBLISHER_PROVIDED_ID) enumeration value to `PretargetingConfig`. |
| February 29th, 2024 | - Introduced the [`mediaPlanner`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.proposals.deals.md.txt#Deal.FIELDS.media_planner) field to `Deal`. - Introduced the [`eligibleSeatIds`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.proposals.deals.md.txt#Deal.FIELDS.eligible_seat_ids) field to `Deal`. - Deal's `billedBuyer` will not be populated if it belongs to a media planner account. |
| November 29th, 2023 | Added the [`AUDIO`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.proposals.deals.md.txt#Deal.CreativeFormat.ENUM_VALUES.AUDIO) enum value to `CreativeFormat`. Added the [`LG_TV`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.publisherProfiles.md.txt#AppStoreType.ENUM_VALUES.LG_TV) enum value to `AppStoreType`. |
| October 11, 2021 | Initial launch of the [Authorized Buyers Marketplace API](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest.md.txt), 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 |
|---|---|
| October 19th, 2026 | - Introduced [`mediaPlanners.search`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1beta/mediaPlanners/search.md.txt) to search for media planner accounts by DSP seat ID. |
| August 25th, 2026 | - Introduced the [`userListId`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1beta/curators.dataSegments.md.txt#DataSegment.FIELDS.user_list_id) field to `DataSegment`. |
| July 20th, 2026 | - Introduced the [`curationFeeVisibility`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1beta/curators.curatedPackages.md.txt#CuratedPackage.FIELDS.curation_fee_visibility) field to `CuratedPackage`. |
| June 29th, 2026 | - Introduced the [`millipercentOfMediaFee`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1beta/curators.dataSegments.md.txt#DataSegment.FIELDS.millipercent_of_media_fee) field to `DataSegment`. - Introduced the [`millipercentOfMediaFee`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1beta/curators.curatedPackages.md.txt#CuratedPackage.FIELDS.millipercent_of_media_fee) field to `CuratedPackage`. |
| 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 |
|---|---|
| October 19th, 2026 | - Introduced [`mediaPlanners.search`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1alpha/mediaPlanners/search.md.txt) to search for media planner accounts by DSP seat ID. |
| August 25th, 2026 | - Introduced the [`userListId`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1alpha/curators.dataSegments#DataSegment.FIELDS.user_list_id) field to `DataSegment`. |
| July 20th, 2026 | - Introduced the [`curationFeeVisibility`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1alpha/curators.curatedPackages.md.txt#CuratedPackage.FIELDS.curation_fee_visibility) field to `CuratedPackage`. |
| June 29th, 2026 | - Introduced the [`millipercentOfMediaFee`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1alpha/buyers.dataSegments.md.txt#DataSegment.FIELDS.millipercent_of_media_fee) field to `DataSegment`. - Introduced the [`millipercentOfMediaFee`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1alpha/curators.curatedPackages.md.txt#CuratedPackage.FIELDS.millipercent_of_media_fee) field to `CuratedPackage`. |
| 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 |
|---|---|
| November 10th, 2026 | Introduced the `adCategoryTaxonomyOverride` query parameter to [`buyers.creatives.get`](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.creatives/get.md.txt), [`buyers.creatives.list`](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.creatives/list.md.txt), and [`bidders.creatives.list`](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives/list.md.txt) methods to let bidders override the [`AdCategoryTaxonomy`](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives.md.txt#adcategorytaxonomy) used in the response. Added the [`IAB_CONTENT_2_2` enum value](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives.md.txt#Creative.AdCategoryTaxonomy.ENUM_VALUES.IAB_CONTENT_2_2) to `AdCategoryTaxonomy`. IAB Content Taxonomy 2.2 can't be configured as the ad category taxonomy for Authorized Buyers or Open Bidding accounts at this time. |
| September 20th, 2026 | Deprecated the [`CERTIFICATE_REQUIRED` status](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives.md.txt#status) and the [`missingCertificate` field](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives.md.txt#Creative.PolicyTopicEntry.FIELDS.missing_certificate) following policy updates that no longer require certificates for gambling and social casino games. |
| September 10th, 2026 | Introduced the [`addDeals` method](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.creatives/addDeals.md.txt) to the `buyers.creatives` resource, letting buyers associate deal IDs (including Programmatic Guaranteed, Private Auction, Preferred Deal, and Marketplace Package) with a creative. |
| July 9th, 2026 | Deprecated the `allowed_user_targeting_modes` field and `UserTargetingMode` enum in [PretargetingConfig](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.pretargetingConfigs.md.txt). |
| May 1st, 2025 | Deprecated value `GOOGLE_RTB` from the [BidProtocol](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.endpoints.md.txt#BidProtocol) enum space. |
| Feb 24th, 2025 | Added new value `GOOGLE_AD_CATEGORY_TAXONOMY` to the [AdCategoryTaxonomy](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives.md.txt#adcategorytaxonomy) enum space. |
| Feb 13th, 2025 | Deprecated declared restricted categories in [Creative](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives.md.txt). |
| August 6th, 2024 | - Introduced the `detectedCategoriesTaxonomy` and `detectedCategories` fields to [CreativeServingDecision](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives.md.txt#creativeservingdecision). |
| July 30th, 2024 | - Introduced the [`PUBLISHER_FIRST_PARTY_ID`](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.pretargetingConfigs.md.txt#UserIdType.ENUM_VALUES.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](https://developers.google.com/authorized-buyers/rtb/cookie-guide.md.txt#bidder-and-google-hosted-match-tables-with-user-lists) |
| October 12st, 2023 | Added the [`RENDERING_PLAYABLE`](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives.md.txt#Creative.CreativeAttribute.ENUM_VALUES.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](https://developers.google.com/authorized-buyers/rtb/cookie-guide.md.txt#bidder-and-google-hosted-match-tables-with-user-lists) |
| March 17th, 2023 | Added the [`missingCertificate`](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives.md.txt#Creative.PolicyTopicEntry.FIELDS.missing_certificate) 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](https://ads-developers.googleblog.com/2022/11/removing-support-for-old-openrtb.html) 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`](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives.md.txt#status) status for some creatives. See [Gambling and games policy](https://support.google.com/authorizedbuyers/answer/7450776) for more information. |
| April 27, 2022 | Release of the [`publisherConnections`](https://developers.google.com/authorized-buyers/apis/guides/rtb-api/publisher-connections.md.txt) resource. Open Bidding exchanges can use `publisherConnections` to manage connections with publishers. |
| Nov 1, 2021 | Introduced [`bidders.enpoints.patch`](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.endpoints/patch.md.txt) 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](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest.md.txt), to eventually replace the Ad Exchange Buyer and Ad Exchange Buyer II APIs. |

## Legacy

> [!WARNING]
> Ad Exchange Buyer API II is deprecated. With the exception of resources used for [RTB
> Troubleshooting](https://developers.google.com/authorized-buyers/apis/guides/v2/rtb-troubleshooting), all others have sunset as of September 29th, 2023. If you need to continue using Marketplace, we recommend [migrating](https://developers.google.com/authorized-buyers/apis/guides/marketplace-migration) to the Marketplace API.

### 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`](https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/accounts.finalizedProposals/pause.md.txt) and [`resume`](https://developers.google.com/authorized-buyers/apis/reference/rest/v2beta1/accounts.finalizedProposals/resume.md.txt) 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](https://developers.google.com/authorized-buyers/apis/guides/v2/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. |