Marketplace API
Version 1.0
- Only PIXEL inventory sizes are allowed for inventory size targeting when calling buyers.proposals.sendRfp .
- Introduced the buyerPermissionType
field to
Deal.
- Introduced the dealOwnerSeatId
field to
AuctionPackage.
- Fixed a bug where
buyers.proposals.addNotecould be used for Private Auction Proposals, which is not a valid workflow because this deal type does not involve negotiation.
- Support for the
orderByparameter has been added tobidders.auctionPackages.list.
MarketplaceTargeting
. Added the vertical_targeting
targeting value to MarketplaceTargeting
.- Introduced
bidders.auctionPackages.listto list auction packages at the bidder level. Auction packages returned by this method list media planners that are subscribed to it with thesubscribedMediaPlannersfield. - Introduced the subscribedBuyers
field to
AuctionPackage. - Introduced the subscribedMediaPlanners
field to
AuctionPackage. - Introduced the eligibleSeatIds
field to
AuctionPackage.
- Introduced the PUBLISHER_PROVIDED_ID
enumeration value to
PretargetingConfig.
- 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.
- 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
- Initial release of the v1beta API.
- The
dataSegmentsresource is now available in v1beta.- The resource path for
dataSegmentshas changed frombuyers/{accountId}/dataSegmentsin v1alpha tocurators/{accountId}/dataSegmentsin v1beta
- The resource path for
Version 1.0 alpha
- Initial release of the v1alpha API.
Real-time Bidding API
Version 1.0
- Introduced the
detectedCategoriesTaxonomyanddetectedCategoriesfields to CreativeServingDecision .
- Introduced the PUBLISHER_FIRST_PARTY_ID
enumeration value to
PretargetingConfig.
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
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
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
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
creatives.renderUrl
field for FLEDGE origin trials.CERTIFICATE_REQUIRED
status for some creatives. See Gambling and games policy
for more information.publisherConnections
resource. Open Bidding exchanges can use publisherConnections
to manage connections with publishers.video
to the Native Creatives resource, which accepts either videoVastXml
or videoUrl
.openAuctionServingStatus
, openBiddingServingStatus
, dealsServingStatus
, chinaServingStatus
and russiaServingStatus
with networkPolicyCompliance
, platformPolicyCompliance
, dealsPolicyCompliance
, chinaPolicyCompliance
and russiaPolicyCompliance
respectively.Legacy
Version 2.0 (Deprecated)
Added the OVERDELIVERED_IMPRESSION
status to the Status
enum of NonBillableWinningBidStatusRow
.
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
Added the detail
field to BidMetricsRow
.
Added the reachedQueries
field to BidMetricsRow
.
Added FATAL_VAST_ERROR
and LOST_IN_MEDIATION
to the Status
enum of NonBillableWinningBidStatusRow
.
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.
