Skip to content
OpenParablePublic APIs

Ad Exchange Buyer API API

by googleapis.com

OAuthHTTPSAnalytics
Open documentation ↗

Overview

Accesses your bidding-account information, submits creatives for validation, finds available direct deals, and retrieves performance reports.

Ad Exchange Buyer API is an analytics API from googleapis.com. Requests are authenticated with OAuth. It is served over HTTPS. Its OpenAPI description documents 38 endpoints.

At a glance

Authentication
OAuth
HTTPS
Yes
CORS
Unknown
Category
Analytics
Base URL
https://www.googleapis.com/adexchangebuyer/v1.4
Version
v1.4
Endpoints
38
OpenAPI
Specification ↗
Spec updated
2021-05-24

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL
curl -X GET "https://www.googleapis.com/adexchangebuyer/v1.4/accounts" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN"
JavaScript
const response = await fetch("https://www.googleapis.com/adexchangebuyer/v1.4/accounts", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_TOKEN",
  },
});
const data = await response.json();
console.log(data);
Python
import requests

response = requests.request(
    "GET",
    "https://www.googleapis.com/adexchangebuyer/v1.4/accounts",
    headers={
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_TOKEN",
    },
    timeout=30,
)
print(response.json())

Endpoints

MethodPathWhat it does
GET/accountsRetrieves the authenticated user's list of accounts.
GET/accounts/{id}Gets one account by ID.
PUT/accounts/{id}Updates an existing account.
PATCH/accounts/{id}Updates an existing account. This method supports patch semantics.
GET/billinginfoRetrieves a list of billing information for all accounts of the authenticated user.
GET/billinginfo/{accountId}Returns the billing information for one account specified by account ID.
GET/billinginfo/{accountId}/{billingId}Returns the budget information for the adgroup specified by the accountId and billingId.
PUT/billinginfo/{accountId}/{billingId}Updates the budget amount for the budget of the adgroup specified by the accountId and billingId, with the budget amount in the request.
PATCH/billinginfo/{accountId}/{billingId}Updates the budget amount for the budget of the adgroup specified by the accountId and billingId, with the budget amount in the request. This method supports pa
GET/creativesRetrieves a list of the authenticated user's active creatives. A creative will be available 30-40 minutes after submission.
POST/creativesSubmit a new creative.
GET/creatives/{accountId}/{buyerCreativeId}Gets the status for a single creative. A creative will be available 30-40 minutes after submission.
POST/creatives/{accountId}/{buyerCreativeId}/addDeal/{dealId}Add a deal id association for the creative.
GET/creatives/{accountId}/{buyerCreativeId}/listDealsLists the external deal ids associated with the creative.
POST/creatives/{accountId}/{buyerCreativeId}/removeDeal/{dealId}Remove a deal id associated with the creative.
GET/performancereportRetrieves the authenticated user's list of performance metrics.
GET/pretargetingconfigs/{accountId}Retrieves a list of the authenticated user's pretargeting configurations.
POST/pretargetingconfigs/{accountId}Inserts a new pretargeting configuration.
GET/pretargetingconfigs/{accountId}/{configId}Gets a specific pretargeting configuration
PUT/pretargetingconfigs/{accountId}/{configId}Updates an existing pretargeting config.
PATCH/pretargetingconfigs/{accountId}/{configId}Updates an existing pretargeting config. This method supports patch semantics.
DELETE/pretargetingconfigs/{accountId}/{configId}Deletes an existing pretargeting config.
POST/privateauction/{privateAuctionId}/updateproposalUpdate a given private auction proposal
GET/products/searchGets the requested product.
GET/products/{productId}Gets the requested product by id.
POST/proposals/insertCreate the given list of proposals
GET/proposals/searchSearch for proposals using pql query
GET/proposals/{proposalId}Get a proposal given its id
GET/proposals/{proposalId}/dealsList all the deals for a given proposal
POST/proposals/{proposalId}/deals/deleteDelete the specified deals from the proposal
POST/proposals/{proposalId}/deals/insertAdd new deals for the specified proposal
POST/proposals/{proposalId}/deals/updateReplaces all the deals in the proposal with the passed in deals
GET/proposals/{proposalId}/notesGet all the notes associated with a proposal
POST/proposals/{proposalId}/notes/insertAdd notes to the proposal
POST/proposals/{proposalId}/setupcompleteUpdate the given proposal to indicate that setup has been completed.
PUT/proposals/{proposalId}/{revisionNumber}/{updateAction}Update the given proposal
PATCH/proposals/{proposalId}/{revisionNumber}/{updateAction}Update the given proposal. This method supports patch semantics.
GET/publisher/{accountId}/profilesGets the requested publisher profile(s) by publisher accountId.

Questions

Does the Ad Exchange Buyer API API need an API key?

Yes. The Ad Exchange Buyer API API uses OAuth authentication; the documentation explains how to get credentials.

Does the Ad Exchange Buyer API API support HTTPS?

Yes, the Ad Exchange Buyer API API is served over HTTPS.

How many endpoints does the Ad Exchange Buyer API API have?

Its OpenAPI description lists 38 endpoints in version v1.4. All of them are shown on this page.

What are alternatives to the Ad Exchange Buyer API API?

Other Analytics APIs include Google Play Integrity API, versionhistory.googleapis.com API, Doc Converter, Perspective Comment Analyzer API, Safe Browsing API.

Compare alternatives →

Google Play Integrity API

Analytics

The Play Integrity API helps you check that you're interacting with your genuine app on a genuine Android device powered by Google Play services. The Play Integrity API has replaced SafetyNet Attestation and Android Device Verification.

OAuth1 endpoints

versionhistory.googleapis.com API

Analytics

Version History API - Prod

No auth4 endpoints

Doc Converter

Analytics

This api converts file formats of OpenXml and OpenOffice documents formats to vector files (e.g., svg)

No auth1 endpoints

Perspective Comment Analyzer API

Analytics

The Perspective Comment Analyzer API provides information about the potential impact of a comment on a conversation (e.g. it can provide a score for the "toxicity" of a comment). Users can leverage the "SuggestCommentScore" method to submit corrections to improve Perspective over time. Users can set the "doNotStore" flag to ensure that all submitted comments are automatically deleted after scores are returned.

OAuth2 endpoints

Safe Browsing API

Analytics

Enables client applications to check web resources (most commonly URLs) against Google-generated lists of unsafe web resources. The Safe Browsing APIs are for non-commercial use only. If you need to use APIs to detect malicious URLs for commercial purposes – meaning “for sale or revenue-generating purposes” – please refer to the Web Risk API.

No auth7 endpoints

Web Fonts Developer API

Analytics

The Google Web Fonts Developer API lets you retrieve information about web fonts served by Google.

No auth1 endpoints

Listed from APIs.guru (CC0).