canonical: https://jentic.com/apis/googleapis.com/adexchangebuyer2 # Google Ad Exchange Buyer API II The Ad Exchange Buyer API II lets Authorized Buyers programmatically manage their accounts on Google's Ad Exchange. It covers client and invitation management, real-time bidding configurations including pretargeting and creatives, auction packages, marketplace programmatic deals (proposals, products, deals, finalized deals), and bidder-level filtering and bid metric reports. Buyers and demand-side platforms use it to provision client buyers, run experiments, troubleshoot bid filtering, and negotiate deals with publishers without using the Authorized Buyers UI. ## For AI agents Manage Authorized Buyers accounts, real-time bidding setup, creatives, and marketplace deals on Google Ad Exchange so an agent can automate client onboarding, deal negotiation, and bid filtering analysis. ## Scope Does not handle DV360 line item trafficking, Google Ads campaign management, or Search Ads - use for Authorized Buyers account, creative, pretargeting, and Marketplace deal management only. ## Capabilities - Create and invite client buyers under an Authorized Buyers account and manage their users - Submit creatives for review and watch their disapproval reasons across exchanges - Configure pretargeting rules that determine which inventory the bidder receives - Negotiate programmatic deals end-to-end: create proposals, send and accept counter-offers, and pause finalized deals - Pull bid metrics and filtering reports to diagnose why bids are dropped before, during, and after auction - List publisher profiles and product catalogue entries to discover marketplace inventory ## Use cases ### Client Buyer Onboarding Automation An agency holding company onboards dozens of brand clients to its Authorized Buyers account each quarter. The accounts.clients endpoints expose create, update, list, invitation, and user operations so the ops team can provision client buyers, send invitations, and track which users have accepted, all without the Authorized Buyers UI. Example prompt: Create a new client buyer 'Acme Corp' under accounts/12345 with role CLIENT_DEAL_NEGOTIATOR, then invite usermail@acme.com and return the invitation ID. ### Creative Review Monitoring A creative team uploads display creatives to Authorized Buyers and needs to know quickly when an exchange disapproves an asset. The accounts.creatives.list operation supports filtering by status and exchange, so the team builds a dashboard that surfaces disapprovals with their reason codes and the affected creatives. Example prompt: List all creatives under accounts/12345 with detectedAdvertiserIds=789 and emit any with servingRestrictions.disapproval present, including the reason code. ### Marketplace Deal Negotiation A demand-side platform negotiates programmatic guaranteed deals with publisher partners through the Marketplace API. Proposals.create, proposals.completeSetup, and finalizedProposals.pause/resume cover the full deal lifecycle, and counter-offers travel through the same proposal resource so both sides see a consistent state. Example prompt: Send a counter-offer on proposal proposals/abc that raises the agreed CPM by 0.50 USD and add a note explaining the change. ### AI Agent Bid Diagnostics An AI agent helps a bidder team understand why bids are being dropped before reaching auction. Through Jentic the agent calls the bidders.filterSets and filteredBidRequests endpoints, summarises the top filtering reasons (publisher exclusion, creative status, frequency cap), and recommends which pretargeting rules to adjust. Example prompt: Create a filterSet covering the last 24 hours, list filteredBidRequests grouped by reason, and reply with the top 3 filtering causes and a recommended pretargeting tweak. ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | /v2beta1/accounts/{accountId}/clients | List client buyers under an Authorized Buyers account | | POST | /v2beta1/accounts/{accountId}/clients | Create a new client buyer | | GET | /v2beta1/accounts/{accountId}/clients/{clientAccountId}/users | List users on a client buyer | | POST | /v2beta1/accounts/{accountId}/clients/{clientAccountId}/invitations | Invite a user to a client buyer | | GET | /v2beta1/accounts/{accountId}/clients/{clientAccountId}/invitations | List pending invitations on a client buyer | ## Key resources - **Accounts and Clients** — Create and manage Authorized Buyers accounts, client buyers, invitations, and client users - **Creatives** — Submit, list, and watch creatives for serving status across exchanges - **Pretargeting** — Configure pretargeting rules that filter inventory before it reaches the bidder - **Proposals and Deals** — Create proposals, negotiate counter-offers, and manage finalized programmatic deals - **Bidders Filter Sets** — Pull filtered bid requests, bid metrics, and impression metrics for diagnostics - **Publisher Profiles and Products** — Discover publisher inventory and the product catalogue available in Marketplace ## Why Jentic - **Setup:** Wiring the Ad Exchange Buyer API II by hand means setting up Google OAuth 2.0 with the adexchange.buyer scope, refreshing short-lived access tokens yourself, and pointing calls at the adexchangebuyer.googleapis.com host. Through Jentic you install once, import the Ad Exchange Buyer API II from the API Directory, store the OAuth credential once, and your agent calls it. - **Permission scoping:** This API puts the account id in the URL path (/v2beta1/accounts/{accountId}/...), so a rule can pin your agent to one Authorized Buyers account: it can read that account's clients and creatives and nothing else. You choose the operations it may call, so write actions like creating clients, sending invitations, or creating proposals are not included unless you add them. - **Credential handling:** Your Google OAuth credential is stored once, encrypted, by your own Jentic One instance and exchanged for short-lived access tokens at execution time. The refresh token never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'create an Authorized Buyers client' or 'list account creatives', and Jentic returns the matching Ad Exchange Buyer operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **Real-time Bidding API** — Newer Google API that supersedes parts of Ad Exchange Buyer for bidder configuration - **DoubleClick Bid Manager API** — Reporting and trafficking for Display & Video 360 alongside Authorized Buyers - **Display & Video 360 API** — Manage DV360 advertisers, line items, and creatives in tandem with Authorized Buyers deals ## FAQ ### What authentication does the Ad Exchange Buyer API II use? It uses Google OAuth 2.0 with the https://www.googleapis.com/auth/adexchange.buyer scope. The calling Google account must be linked to an Authorized Buyers account with the appropriate access. Jentic stores the OAuth credential in its encrypted vault and exchanges it for short-lived access tokens at request time. ### Can I create a programmatic deal entirely through the API? Yes. POST /v2beta1/accounts/{accountId}/proposals creates a proposal, /proposals/{proposalId}:addNote and :completeSetup move it through negotiation, and finalizedProposals/{proposalId}:pause and :resume control the live state. Both buyer and seller sides see the same proposal resource. ### What are the rate limits for the Ad Exchange Buyer API II? Google enforces a default quota of 1,000 queries per 100 seconds per user per project. Bidder-level filterSet operations can be heavier and may return paginated results - clients must follow nextPageToken to retrieve full result sets. ### How do I list creatives under an Authorized Buyers account through Jentic? Run jentic search 'list authorized buyers creatives', load the accounts.creatives.list operation, and execute it with accountId set to your Authorized Buyers ID. The agent receives a typed list of creatives with servingRestrictions and detectedAdvertiserIds. ### Is the Ad Exchange Buyer API II free? Yes. The API has no per-call fee. Authorized Buyers participation, creative review, and Marketplace deals are governed by the Authorized Buyers commercial terms separately from API access. ### Can I limit what my agent is allowed to do with the Ad Exchange Buyer API II? Yes. Because you run Jentic One yourself, you decide which operations your agent may call and which credential it uses. Since this API puts the account id in the URL path (/v2beta1/accounts/{accountId}/...), your rules can pin the agent to a single Authorized Buyers account and let it only read that account's clients and creatives. Write actions such as creating client buyers, sending invitations, or creating proposals stay off limits unless you explicitly add them.