# Marketplace API ## Overview The [Authorized Buyers Marketplace API](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest) is a collection of resources that buyers can use to programmatically manage the following: - Negotiations with publishers - Auction packages - Client access to the Authorized Buyers Marketplace UI This guide introduces the Marketplace API, and explains how Marketplace API resources map to Marketplace features in the [Authorized Buyers UI](https://realtimebidding.google.com/#MARKETPLACE/MarketplaceDiscoveryPlace:marketplaceDiscovery). ## Bidders and buyers The Marketplace API is consistent with the structure of the [Real-time Bidding API](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest). Both APIs use [`bidders`](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders) and [`buyers`](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers) as root-level resources for bidder and buyer operations. You can use the same bidder and buyer names in resource paths for the Real-time Bidding and Marketplace APIs. > [!NOTE] > **Note:** Although `bidders` and `buyers` are root-level resources, you can't call them in the Marketplace API. Use the Real-time Bidding API to access `bidders` or `buyers` with your[OAuth 2.0](https://developers.google.com/identity/protocols/oauth2) credentials. ## Clients and client users You can use the Marketplace API to create and manage [clients](https://developers.google.com/authorized-buyers/apis/guides/marketplace/clients) and [client users](https://developers.google.com/authorized-buyers/apis/guides/marketplace/client-users), and to programmatically grant agencies or advertisers access to your **Marketplace** tab in the Authorized Buyers UI. A [`Client`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.clients#resource:-client) represents a client, agency or advertiser associated with your Authorized Buyers account. A [`ClientUser`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.clients.users#resource:-clientuser) represents a specific individual that has UI access under a `Client`. Client users can't access the Marketplace API. Client users have limited access to your account's **Marketplace** tab. Client user permissions are determined by the `role` specified in their parent `Client`. Other resources in the Marketplace API refer to clients by the name specified in the `Clients` resource. To learn more about clients and client users in the Authorized Buyers Marketplace UI, see the following Help Center articles: - [Create and manage clients and client users](https://support.google.com/authorizedbuyers/answer/6154085#zippy=%2Cmanage-clients%2Cadd-or-manage-client-users). - [Types of client access permissions](https://support.google.com/authorizedbuyers/answer/6155351). ## Media Planners A media planner is an agency or other entity that independently negotiates deals with publishers, and allows one or more bidders to place bids on behalf of their finalized deals. These deals are either private auction or preferred deals, and you won't be able to view or interact with them until they are finalized--after which, they will appear in the `bidders.finalizedDeals.list` response. To determine if a given finalized deal was negotiated by a media planner, you can check whether the deal's [`mediaPlanner`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.proposals.deals#Deal.FIELDS.media_planner) field has been populated. Media planners set a list of DSP-specific seat IDs that are eligible to transact on the deal, which can be viewed with the [`eligibleSeatIds`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.proposals.deals#Deal.FIELDS.eligible_seat_ids) field. In Real-time Bidding bid requests, these seat IDs may appear in allowlists or blocklists set by the publisher, which will determine whether bids are filtered from the auction. They can appear in the following `BidRequest` fields: - OpenRTB protocol - `BidRequest.wseat` - `BidRequest.bseat` - `BidRequest.imp.pmp.deals.wseat` - Google RTB protocol - `BidRequest.adslot.allowed_seat_ids` - `BidRequest.adslot.blocked_seat_ids` - `BidRequest.adslot.matching_ad_data.direct_deal.allowed_seat_ids` ## Auction packages You can use the Marketplace API to subscribe and unsubscribe buyers and clients from [auction packages](https://developers.google.com/authorized-buyers/apis/guides/marketplace/auction-packages), and to view the auction packages you're subscribed to. An [`AuctionPackage`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.auctionPackages#resource:-auctionpackage) is similar to a bundle of targeting for Marketplace inventory. For example, an auction package might target a collection of URLs and mobile application IDs that are relevant to a buyer's business interests. You can't create new auction packages with the Marketplace API. You can use the Authorized Buyers Marketplace UI to create auction packages. The Marketplace API doesn't include specific targeting information associated with auction packages. You can share auction packages with other buyers and clients, and can have auction packages created by Google or other buyers shared with you. See [Auction packages](https://support.google.com/authorizedbuyers/answer/7516884) for more information. ## Publisher profiles You can use the Marketplace API to view [profiles](https://developers.google.com/authorized-buyers/apis/guides/marketplace/publisher-profiles) for publishers you can negotiate with. A [`PublisherProfile`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.publisherProfiles#resource:-publisherprofile) represents a publisher in the Marketplace API. Other resources in the Marketplace API refer to publishers with the name specified in their `PublisherProfile`. Publisher profiles have similar information to **Publishers** in the **Discovery** tab of the Authorized Buyers Marketplace UI. See [How to discover publishers](https://support.google.com/authorizedbuyers/answer/6055429#browse-available-publishers-and-publisher-inventory) for more information. ## Proposals and deals You can use the Marketplace API to negotiate deals with publishers. Here are some ways you can use the Marketplace API to manage deals: - [Send new proposals](https://developers.google.com/authorized-buyers/apis/guides/marketplace/deals#create_proposals). - [Negotiate with publishers](https://developers.google.com/authorized-buyers/apis/guides/marketplace/deals#negotiate_with_publishers). - [Finalize deals](https://developers.google.com/authorized-buyers/apis/guides/marketplace/deals#finalize_deals). - [Serve finalized deals](https://developers.google.com/authorized-buyers/apis/guides/marketplace/deals#serve_finalized_deals). - [Start renegotiation of finalized deals](https://developers.google.com/authorized-buyers/apis/guides/marketplace/deals#start_renegotiation). [Proposals](https://developers.google.com/authorized-buyers/apis/guides/marketplace/proposals) represent the latest negotiation status of one or more deals between a buyer or client and a publisher, and are similar to the Authorized Buyers Marketplace UI's **Negotiations** tab. [Deals](https://developers.google.com/authorized-buyers/apis/guides/marketplace/deals) represent the latest terms of a deal being negotiated under a given proposal, and are comparable to the Authorized Buyers Marketplace UI's list of deals labeled **CURRENT NEGOTIATION** for a given proposal. [Finalized deals](https://developers.google.com/authorized-buyers/apis/guides/marketplace/finalized-deals) represent deals that have completed the negotiation phase and are ready to serve. This includes deals that are already serving. Finalized deals are similar to the Authorized Buyers Marketplace UI's **Deals** tab. Depending on the type of deal you're negotiating, behavior might differ between Marketplace API resources. For example, buyers can't initiate negotiations for all deal types. To learn more about the Marketplace API implementation for negotiations, see the following resources: - [`buyers.proposals`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.proposals) - [`buyers.proposals.deals`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.proposals.deals) - [`buyers.finalizedDeals`](https://developers.google.com/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.finalizedDeals) To learn more about negotiations in the Authorized Buyers Marketplace UI, see the following: - [Negotiate a deal](https://support.google.com/authorizedbuyers/answer/6055431). - [Request a proposal for publisher inventory](https://support.google.com/authorizedbuyers/answer/6347848). - [Manage your deals](https://support.google.com/authorizedbuyers/answer/6224755).