Method: customBiddingAlgorithms.rules.create

  • This document outlines how to create a new custom bidding rules resource using an HTTP POST request to a specified URL with required path and query parameters.

  • The request requires a request body containing an instance of CustomBiddingAlgorithmRules and will return a newly created instance of CustomBiddingAlgorithmRules in the response body if successful.

  • Creating custom bidding rules under an algorithm assigned to a line item is not allowed and will result in an error.

  • The process requires authorization through an OAuth scope, specifically https://www.googleapis.com/auth/display-video.

Creates a new rules resource. Returns the newly created rules resource if successful.

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

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
customBiddingAlgorithmId

string (int64 format)

Required. The ID of the custom bidding algorithm that owns the rules resource.

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 rules resource.
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 CustomBiddingAlgorithmRules.

Response body

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

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.