Method: customBiddingAlgorithms.scripts.create

  • Use Display & Video 360 API v4 instead of the sunset v3.

  • This document describes how to create a new custom bidding script using the Display & Video 360 API v3.

  • A new custom bidding script is created under a specific custom bidding algorithm using a POST request.

  • The request requires specifying the custom bidding algorithm ID and the owner (partner or advertiser) of the algorithm.

  • The request and response bodies contain instances of CustomBiddingScript.

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

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/v3/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.