Method: customBiddingAlgorithms.scripts.create

  • This page details how to create a new custom bidding script using a POST request to a specific URL.

  • Creating a script requires specifying the customBiddingAlgorithmId in the path and either a partnerId or advertiserId as a query parameter.

  • The request body should contain an instance of CustomBiddingScript, and the response body will be a new instance of CustomBiddingScript if successful.

  • The process requires authorization using the https://www.googleapis.com/auth/display-video OAuth scope.

Creates a new custom bidding script. Returns the newly created script if successful.

Requests creating a custom bidding script under an algorithm assigned to a line item will return an error.

HTTP request

POST https://displayvideo.googleapis.com/v4/customBiddingAlgorithms/{customBiddingAlgorithmId}/scripts

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
customBiddingAlgorithmId

string (int64 format)

Required. The ID of the custom bidding algorithm that owns the script.

Query parameters

Parameters
Union parameter owner. Required. Identifies the DV360 entity that owns the parent custom bidding algorithm. It can be either a partner or an advertiser. owner can be only one of the following:
partnerId

string (int64 format)

The ID of the partner that owns the parent custom bidding algorithm.

Only this partner will have write access to this custom bidding script.
advertiserId

string (int64 format)

The ID of the advertiser that owns the parent custom bidding algorithm.

Request body

The request body contains an instance of CustomBiddingScript.

Response body

If successful, the response body contains a newly created instance of CustomBiddingScript.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/display-video

For more information, see the OAuth 2.0 Overview.