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

- [REST Resource: v1.bidders](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest#v1.bidders)
- [REST Resource: v1.bidders.creatives](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest#v1.bidders.creatives)
- [REST Resource: v1.bidders.endpoints](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest#v1.bidders.endpoints)
- [REST Resource: v1.bidders.pretargetingConfigs](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest#v1.bidders.pretargetingConfigs)
- [REST Resource: v1.bidders.publisherConnections](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest#v1.bidders.publisherConnections)
- [REST Resource: v1.buyers](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest#v1.buyers)
- [REST Resource: v1.buyers.creatives](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest#v1.buyers.creatives)
- [REST Resource: v1.buyers.userLists](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest#v1.buyers.userLists)

## Service: realtimebidding.googleapis.com

To call this service, we recommend that you use the Google-provided [client libraries](https://cloud.google.com/apis/docs/client-libraries-explained). 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](https://developers.google.com/discovery/v1/reference/apis) 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 document:

- <https://realtimebidding.googleapis.com/$discovery/rest?version=v1>

### Service endpoint

A [service endpoint](https://cloud.google.com/apis/design/glossary#api_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: [v1.bidders](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders)

| Methods ||
|---|---|
| `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders/get` | `GET /v1/{name=bidders/*}` Gets a bidder account by its name. |
| `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders/list` | `GET /v1/bidders` Lists all the bidder accounts that belong to the caller. |

## REST Resource: [v1.bidders.creatives](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives)

| Methods ||
|---|---|
| `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives/list` | `GET /v1/{parent=bidders/*}/creatives` Lists creatives as they are at the time of the initial request. |
| `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.creatives/watch` | `POST /v1/{parent=bidders/*}/creatives:watch` Watches all creatives pertaining to a bidder. |

## REST Resource: [v1.bidders.endpoints](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.endpoints)

| Methods ||
|---|---|
| `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.endpoints/get` | `GET /v1/{name=bidders/*/endpoints/*}` Gets a bidder endpoint by its name. |
| `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.endpoints/list` | `GET /v1/{parent=bidders/*}/endpoints` Lists all the bidder's endpoints. |
| `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.endpoints/patch` | `PATCH /v1/{endpoint.name=bidders/*/endpoints/*}` Updates a bidder's endpoint. |

## REST Resource: [v1.bidders.pretargetingConfigs](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.pretargetingConfigs)

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

## REST Resource: [v1.bidders.publisherConnections](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.publisherConnections)

| Methods ||
|---|---|
| `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.publisherConnections/batchApprove` | `POST /v1/{parent=bidders/*}/publisherConnections:batchApprove` Batch approves multiple publisher connections. |
| `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.publisherConnections/batchReject` | `POST /v1/{parent=bidders/*}/publisherConnections:batchReject` Batch rejects multiple publisher connections. |
| `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.publisherConnections/get` | `GET /v1/{name=bidders/*/publisherConnections/*}` Gets a publisher connection. |
| `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/bidders.publisherConnections/list` | `GET /v1/{parent=bidders/*}/publisherConnections` Lists publisher connections for a given bidder. |

## REST Resource: [v1.buyers](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers)

| Methods ||
|---|---|
| `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers/get` | `GET /v1/{name=buyers/*}` Gets a buyer account by its name. |
| `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers/getRemarketingTag` | `GET /v1/{name=buyers/*}:getRemarketingTag` This has been sunset as of October 2023, and will return an error response if called. |
| `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers/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](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.creatives)

| Methods ||
|---|---|
| `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.creatives/addDeals` | `POST /v1/{name=buyers/*/creatives/*}:addDeals` Adds a list of deals to a creative, which submits the creative for publisher review. |
| `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.creatives/create` | `POST /v1/{parent=buyers/*}/creatives` Creates a creative. |
| `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.creatives/get` | `GET /v1/{name=buyers/*/creatives/*}` Gets a creative. |
| `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.creatives/list` | `GET /v1/{parent=buyers/*}/creatives` Lists creatives as they are at the time of the initial request. |
| `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.creatives/patch` | `PATCH /v1/{creative.name=buyers/*/creatives/*}` Updates a creative. |

## REST Resource: [v1.buyers.userLists](https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.userLists)

| Methods ||
|---|---|
| `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.userLists/close` | `POST /v1/{name=buyers/*/userLists/*}:close` Changes the status of a user list to CLOSED. |
| `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.userLists/create` | `POST /v1/{parent=buyers/*}/userLists` Creates a new user list. |
| `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.userLists/get` | `GET /v1/{name=buyers/*/userLists/*}` Gets a user list by its name. |
| `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.userLists/getRemarketingTag` | `GET /v1/{name=buyers/*/userLists/*}:getRemarketingTag` This has been sunset as of October 2023, and will return an error response if called. |
| `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.userLists/list` | `GET /v1/{parent=buyers/*}/userLists` Lists the user lists visible to the current user. |
| `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.userLists/open` | `POST /v1/{name=buyers/*/userLists/*}:open` Changes the status of a user list to OPEN. |
| `https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/v1/buyers.userLists/update` | `PUT /v1/{userList.name=buyers/*/userLists/*}` Updates the given user list. |