[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間：2025-07-25 (世界標準時間)。"],[[["\u003cp\u003eThe Authorized Buyers Marketplace API allows buyers to programmatically manage negotiations, auction packages, and client access to the Authorized Buyers Marketplace UI.\u003c/p\u003e\n"],["\u003cp\u003eThis API enables the creation and management of clients and client users, granting agencies or advertisers access to the Marketplace tab within the Authorized Buyers UI.\u003c/p\u003e\n"],["\u003cp\u003eBuyers can utilize the API to subscribe to auction packages, bundles of targeted Marketplace inventory, and view their subscriptions.\u003c/p\u003e\n"],["\u003cp\u003ePublisher profiles are accessible through the API, providing information similar to the Publishers section in the Authorized Buyers Marketplace UI.\u003c/p\u003e\n"],["\u003cp\u003eThe API facilitates deal negotiation with publishers, including sending proposals, finalizing deals, and managing the entire negotiation process.\u003c/p\u003e\n"]]],["The Marketplace API enables programmatic management of negotiations, auction packages, and client access within the Authorized Buyers Marketplace. Key actions include managing clients and client users to grant UI access, subscribing to/viewing auction packages, and viewing publisher profiles. Users can negotiate deals with publishers by sending proposals, finalizing deals, and managing finalized deals. The API supports managing deals negotiated by media planners and accessing information through various resources. The Real-time Bidding API should be used for access to `bidders` and `buyers`.\n"],null,["# Marketplace API\n\nOverview\n--------\n\nThe [Authorized Buyers Marketplace\nAPI](/authorized-buyers/apis/marketplace/reference/rest) is a collection of\nresources that buyers can use to programmatically manage the following:\n\n- Negotiations with publishers\n- Auction packages\n- Client access to the Authorized Buyers Marketplace UI\n\nThis guide introduces the Marketplace API, and explains how Marketplace API\nresources map to Marketplace features in the [Authorized Buyers\nUI](//realtimebidding.google.com/#MARKETPLACE/MarketplaceDiscoveryPlace:marketplaceDiscovery).\n\nBidders and buyers\n------------------\n\nThe Marketplace API is consistent with the structure of the [Real-time Bidding\nAPI](/authorized-buyers/apis/realtimebidding/reference/rest). Both APIs use\n[`bidders`](/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders)\nand [`buyers`](/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers)\nas root-level resources for bidder and buyer operations. You can use the same\nbidder and buyer names in resource paths for the Real-time Bidding and\nMarketplace APIs.\n| **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](/identity/protocols/oauth2) credentials.\n\nClients and client users\n------------------------\n\nYou can use the Marketplace API to create and manage\n[clients](/authorized-buyers/apis/guides/marketplace/clients) and\n[client users](/authorized-buyers/apis/guides/marketplace/client-users), and to\nprogrammatically grant agencies or advertisers access to your **Marketplace**\ntab in the Authorized Buyers UI.\n\nA [`Client`](/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.clients#resource:-client)\nrepresents a client, agency or advertiser associated with your Authorized\nBuyers account.\n\nA [`ClientUser`](/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.clients.users#resource:-clientuser)\nrepresents a specific individual that has UI access under a `Client`. Client\nusers can't access the Marketplace API. Client users have limited access to your\naccount's **Marketplace** tab. Client user permissions are determined by the\n`role` specified in their parent `Client`.\n\nOther resources in the Marketplace API refer to clients by the name specified\nin the `Clients` resource.\n\nTo learn more about clients\nand client users in the Authorized Buyers Marketplace UI, see the following\nHelp Center articles:\n\n- [Create and manage clients and client users](//support.google.com/authorizedbuyers/answer/6154085#zippy=%2Cmanage-clients%2Cadd-or-manage-client-users).\n- [Types of client access permissions](//support.google.com/authorizedbuyers/answer/6155351).\n\nMedia Planners\n--------------\n\nA media planner is an agency or other entity that independently negotiates\ndeals with publishers, and allows one or more bidders to place bids on behalf\nof their finalized deals. These deals are either private auction or preferred\ndeals, and you won't be able to view or interact with them until they are\nfinalized--after which, they will appear in the `bidders.finalizedDeals.list`\nresponse.\n\nTo determine if a given finalized deal was negotiated by a media planner, you\ncan check whether the deal's [`mediaPlanner`](/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.proposals.deals#Deal.FIELDS.media_planner)\nfield has been populated. Media planners set a list of DSP-specific seat IDs\nthat are eligible to transact on the deal, which can be viewed with the\n[`eligibleSeatIds`](/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.proposals.deals#Deal.FIELDS.eligible_seat_ids)\nfield. In Real-time Bidding bid requests, these seat IDs may appear in\nallowlists or blocklists set by the publisher, which will determine whether\nbids are filtered from the auction. They can appear in the following\n`BidRequest` fields:\n\n- OpenRTB protocol\n - `BidRequest.wseat`\n - `BidRequest.bseat`\n - `BidRequest.imp.pmp.deals.wseat`\n- Google RTB protocol\n - `BidRequest.adslot.allowed_seat_ids`\n - `BidRequest.adslot.blocked_seat_ids`\n - `BidRequest.adslot.matching_ad_data.direct_deal.allowed_seat_ids`\n\nAuction packages\n----------------\n\nYou can use the Marketplace API to subscribe and unsubscribe buyers and clients\nfrom [auction\npackages](/authorized-buyers/apis/guides/marketplace/auction-packages), and to\nview the auction packages you're subscribed to.\n\nAn [`AuctionPackage`](/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.auctionPackages#resource:-auctionpackage)\nis similar to a bundle of targeting for Marketplace inventory. For example, an\nauction package might target a collection of URLs and mobile application IDs\nthat are relevant to a buyer's business interests.\n\nYou can't create new auction packages with the Marketplace API. You can use the\nAuthorized Buyers Marketplace UI to create auction packages. The Marketplace API\ndoesn't include specific targeting information associated with auction packages.\n\nYou can share auction packages with other buyers and clients, and can have\nauction packages created by Google or other buyers shared with you.\n\nSee [Auction packages](//support.google.com/authorizedbuyers/answer/7516884) for\nmore information.\n\nPublisher profiles\n------------------\n\nYou can use the Marketplace API to view\n[profiles](/authorized-buyers/apis/guides/marketplace/publisher-profiles) for\npublishers you can negotiate with.\n\nA [`PublisherProfile`](/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.publisherProfiles#resource:-publisherprofile)\nrepresents a publisher in the Marketplace API. Other resources in the\nMarketplace API refer to publishers with the name specified in their\n`PublisherProfile`.\n\nPublisher profiles have similar information to **Publishers** in the\n**Discovery** tab of the Authorized Buyers Marketplace UI.\n\nSee [How to discover\npublishers](//support.google.com/authorizedbuyers/answer/6055429#browse-available-publishers-and-publisher-inventory)\nfor more information.\n\nProposals and deals\n-------------------\n\nYou can use the Marketplace API to negotiate deals with publishers. Here\nare some ways you can use the Marketplace API to manage deals:\n\n- [Send new proposals](/authorized-buyers/apis/guides/marketplace/deals#create_proposals).\n- [Negotiate with publishers](/authorized-buyers/apis/guides/marketplace/deals#negotiate_with_publishers).\n- [Finalize deals](/authorized-buyers/apis/guides/marketplace/deals#finalize_deals).\n- [Serve finalized deals](/authorized-buyers/apis/guides/marketplace/deals#serve_finalized_deals).\n- [Start renegotiation of finalized deals](/authorized-buyers/apis/guides/marketplace/deals#start_renegotiation).\n\n[Proposals](/authorized-buyers/apis/guides/marketplace/proposals) represent the\nlatest negotiation status of one or more deals between a buyer or client and a\npublisher, and are similar to the Authorized Buyers Marketplace UI's\n**Negotiations** tab.\n\n[Deals](/authorized-buyers/apis/guides/marketplace/deals) represent the latest\nterms of a deal being negotiated under a given proposal, and are comparable to\nthe Authorized Buyers Marketplace UI's list of deals labeled **CURRENT\nNEGOTIATION** for a given proposal.\n\n[Finalized deals](/authorized-buyers/apis/guides/marketplace/finalized-deals)\nrepresent deals that have completed the negotiation phase and are ready to\nserve. This includes deals that are already serving. Finalized deals are\nsimilar to the Authorized Buyers Marketplace UI's **Deals** tab.\n\nDepending on the type of deal you're negotiating, behavior might differ between\nMarketplace API resources. For example, buyers can't initiate negotiations for\nall deal types. To learn more about the Marketplace API implementation for\nnegotiations, see the following resources:\n\n- [`buyers.proposals`](/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.proposals)\n- [`buyers.proposals.deals`](/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.proposals.deals)\n- [`buyers.finalizedDeals`](/authorized-buyers/apis/marketplace/reference/rest/v1/buyers.finalizedDeals)\n\nTo learn more about negotiations in the Authorized Buyers Marketplace UI, see\nthe following:\n\n- [Negotiate a deal](//support.google.com/authorizedbuyers/answer/6055431).\n- [Request a proposal for publisher inventory](//support.google.com/authorizedbuyers/answer/6347848).\n- [Manage your deals](//support.google.com/authorizedbuyers/answer/6224755)."]]
