# REST Resource: customers.customBiddingAlgorithms

- [Resource: CustomBiddingAlgorithm](https://developers.google.com/ads-data-hub/reference/rest/v1/customers.customBiddingAlgorithms#CustomBiddingAlgorithm)
  - [JSON representation](https://developers.google.com/ads-data-hub/reference/rest/v1/customers.customBiddingAlgorithms#CustomBiddingAlgorithm.SCHEMA_REPRESENTATION)
- [Methods](https://developers.google.com/ads-data-hub/reference/rest/v1/customers.customBiddingAlgorithms#METHODS_SUMMARY)

## Resource: CustomBiddingAlgorithm

Defines an Ads Data Hub-managed custom bidding algorithm.

| JSON representation |
|---|
| ``` { "name": string, "customBiddingAlgorithmId": string, "adsDataCustomerId": string, "title": string, "customBiddingQuery": string, "dv360PartnerId": string, "dv360AdvertiserId": [ string ], "deleteTime": string, "createEmail": string } ``` |

| Fields ||
|---|---|
| `name` | `string` Output only. Immutable. Name that uniquely identifies an Ads Data Hub custom bidding algorithm. It has the form customers/\[customerId\]/customBiddingAlgorithms/\[customBiddingAlgorithmId\] |
| `customBiddingAlgorithmId` | `string (https://developers.google.com/discovery/v1/type-format format)` Output only. Immutable. Custom Bidding Algorithm ID. This field is generated by the service and is used in DV360 to reference this algorithm when setting the bidding strategy. |
| `adsDataCustomerId` | `string (https://developers.google.com/discovery/v1/type-format format)` Immutable. Linked Ads Data Hub customer ID associated with this custom bidding algorithm. This customer's data is used when running ScoreImpressionsForCustomBidding on this custom bidding algorithm. |
| `title` | `string` Required. Custom Bidding Algorithm title, which is unique for the specified adsDataCustomerId. |
| `customBiddingQuery` | `string` Required. Immutable. The Ads Data Hub custom bidding query resource that specifies how impressions are scored for this custom bidding algorithm. |
| `dv360PartnerId` | `string (https://developers.google.com/discovery/v1/type-format format)` Immutable. DV360 Partner ID that this custom bidding algorithm is for. |
| `dv360AdvertiserId[]` | `string (https://developers.google.com/discovery/v1/type-format format)` DV360 Advertiser IDs that can use this custom bidding algorithm. |
| `deleteTime` | ``string (`https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp` format)`` Output only. If set, the time this custom bidding algorithm was deleted. If unset, this custom bidding algortihm is active. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: `"2014-10-02T15:01:23Z"` and `"2014-10-02T15:01:23.045123456Z"`. |
| `createEmail` | `string` Output only. Immutable. Email address of the user that created this custom bidding algorithm. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/ads-data-hub/reference/rest/v1/customers.customBiddingAlgorithms/addAdvertiser` | Add a DV360 advertiser to the custom bidding algorithm's advertisers. |
| ### `https://developers.google.com/ads-data-hub/reference/rest/v1/customers.customBiddingAlgorithms/create` | Creates an Ads Data Hub-managed custom bidding algorithm. |
| ### `https://developers.google.com/ads-data-hub/reference/rest/v1/customers.customBiddingAlgorithms/delete` | Delete this custom bidding algorithm. |
| ### `https://developers.google.com/ads-data-hub/reference/rest/v1/customers.customBiddingAlgorithms/execute` | Scores the last 30 days of impressions for the custom bidding models. |
| ### `https://developers.google.com/ads-data-hub/reference/rest/v1/customers.customBiddingAlgorithms/get` | Retrieves the requested Ads Data Hub-managed custom bidding algorithm. |
| ### `https://developers.google.com/ads-data-hub/reference/rest/v1/customers.customBiddingAlgorithms/list` | Lists the custom bidding algorithms managed by the specified Ads Data Hub customer. |
| ### `https://developers.google.com/ads-data-hub/reference/rest/v1/customers.customBiddingAlgorithms/patch` | Updates the requested Ads Data Hub-managed custom bidding algorithm. |
| ### `https://developers.google.com/ads-data-hub/reference/rest/v1/customers.customBiddingAlgorithms/removeAdvertiser` | Remove a DV360 advertiser from the custom bidding algorithm's advertisers. |