Real-time Bidding API

Allows external bidders to manage their RTB integration with Google. This includes managing bidder endpoints, QPS quotas, configuring what ad inventory to receive via pretargeting, submitting creatives for verification, and accessing creative metadata such as approval status.

Service: realtimebidding.googleapis.com

To call this service, we recommend that you use the Google-provided client libraries. If your application needs to use your own libraries to call this service, use the following information when you make the API requests.

Discovery document

A Discovery Document is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery documents:

Service endpoint

A service endpoint is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

  • https://realtimebidding.googleapis.com

REST Resource: v1alpha.bidders.biddingFunctions

Methods
activate POST /v1alpha/{name=bidders/*/biddingFunctions/*}:activate
Activates an existing bidding function.
archive POST /v1alpha/{name=bidders/*/biddingFunctions/*}:archive
Archives an existing bidding function.
create POST /v1alpha/{parent=bidders/*}/biddingFunctions
Creates a new bidding function.
list GET /v1alpha/{parent=bidders/*}/biddingFunctions
Lists the bidding functions that a bidder currently has registered.

REST Resource: v1.bidders

Methods
get GET /v1/{name=bidders/*}
Gets a bidder account by its name.
list GET /v1/bidders
Lists all the bidder accounts that belong to the caller.

REST Resource: v1.bidders.creatives

Methods
list GET /v1/{parent=bidders/*}/creatives
Lists creatives.
watch POST /v1/{parent=bidders/*}/creatives:watch
Watches all creatives pertaining to a bidder.

REST Resource: v1.bidders.endpoints

Methods
get GET /v1/{name=bidders/*/endpoints/*}
Gets a bidder endpoint by its name.
list GET /v1/{parent=bidders/*}/endpoints
Lists all the bidder's endpoints.
patch PATCH /v1/{endpoint.name=bidders/*/endpoints/*}
Updates a bidder's endpoint.

REST Resource: v1.bidders.pretargetingConfigs

Methods
activate POST /v1/{name=bidders/*/pretargetingConfigs/*}:activate
Activates a pretargeting configuration.
addTargetedApps POST /v1/{pretargetingConfig=bidders/*/pretargetingConfigs/*}:addTargetedApps
Adds targeted apps to the pretargeting configuration.
addTargetedPublishers POST /v1/{pretargetingConfig=bidders/*/pretargetingConfigs/*}:addTargetedPublishers
Adds targeted publishers to the pretargeting config.
addTargetedSites POST /v1/{pretargetingConfig=bidders/*/pretargetingConfigs/*}:addTargetedSites
Adds targeted sites to the pretargeting configuration.
create POST /v1/{parent=bidders/*}/pretargetingConfigs
Creates a pretargeting configuration.
delete DELETE /v1/{name=bidders/*/pretargetingConfigs/*}
Deletes a pretargeting configuration.
get GET /v1/{name=bidders/*/pretargetingConfigs/*}
Gets a pretargeting configuration.
list GET /v1/{parent=bidders/*}/pretargetingConfigs
Lists all pretargeting configurations for a single bidder.
patch PATCH /v1/{pretargetingConfig.name=bidders/*/pretargetingConfigs/*}
Updates a pretargeting configuration.
removeTargetedApps POST /v1/{pretargetingConfig=bidders/*/pretargetingConfigs/*}:removeTargetedApps
Removes targeted apps from the pretargeting configuration.
removeTargetedPublishers POST /v1/{pretargetingConfig=bidders/*/pretargetingConfigs/*}:removeTargetedPublishers
Removes targeted publishers from the pretargeting config.
removeTargetedSites POST /v1/{pretargetingConfig=bidders/*/pretargetingConfigs/*}:removeTargetedSites
Removes targeted sites from the pretargeting configuration.
suspend POST /v1/{name=bidders/*/pretargetingConfigs/*}:suspend
Suspends a pretargeting configuration.

REST Resource: v1.buyers

Methods
get GET /v1/{name=buyers/*}
Gets a buyer account by its name.
getRemarketingTag GET /v1/{name=buyers/*}:getRemarketingTag
Gets remarketing tag for a buyer.
list GET /v1/buyers
Lists all buyer account information the calling buyer user or service account is permissioned to manage.

REST Resource: v1.buyers.creatives

Methods
create POST /v1/{parent=buyers/*}/creatives
Creates a creative.
get GET /v1/{name=buyers/*/creatives/*}
Gets a creative.
list GET /v1/{parent=buyers/*}/creatives
Lists creatives.
patch PATCH /v1/{creative.name=buyers/*/creatives/*}
Updates a creative.

REST Resource: v1.buyers.userLists

Methods
close POST /v1/{name=buyers/*/userLists/*}:close
Change the status of a user list to CLOSED.
create POST /v1/{parent=buyers/*}/userLists
Create a new user list.
get GET /v1/{name=buyers/*/userLists/*}
Gets a user list by its name.
getRemarketingTag GET /v1/{name=buyers/*/userLists/*}:getRemarketingTag
Gets remarketing tag for a buyer.
list GET /v1/{parent=buyers/*}/userLists
Lists the user lists visible to the current user.
open POST /v1/{name=buyers/*/userLists/*}:open
Change the status of a user list to OPEN.
update PUT /v1/{userList.name=buyers/*/userLists/*}
Update the given user list.