Every new line item needs to declare whether or not they will serve Eurpoean Union (EU) political ads. Display & Video 360 API and SDF uploads that don't provide declarations will fail. See our deprecations page for more details.

Method: advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.create

AI-generated Key Takeaways

This operation assigns a targeting option to an insertion order, supporting various targeting types like age range, browser, category, and more.
The HTTP request is a POST request to a specific URL structure including advertiser ID, insertion order ID, and targeting type.
The request body should contain an instance of AssignedTargetingOption defining the targeting details.
If successful, the response returns the assigned AssignedTargetingOption object.
This operation requires the https://www.googleapis.com/auth/display-video OAuth scope for authorization.

HTTP request
Path parameters
Request body
Response body
Authorization scopes
Try it!

Assigns a targeting option to an insertion order. Returns the assigned targeting option if successful.

Supported targeting types:

HTTP request

POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}/targetingTypes/{targetingType}/assignedTargetingOptions

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters

Parameters
`advertiserId`	`string (int64 format)` Required. The ID of the advertiser the insertion order belongs to.
`insertionOrderId`	`string (int64 format)` Required. The ID of the insertion order the assigned targeting option will belong to.
`targetingType`	`enum (TargetingType)` Required. Identifies the type of this assigned targeting option. Supported targeting types: `TARGETING_TYPE_AGE_RANGE` `TARGETING_TYPE_BROWSER` `TARGETING_TYPE_CATEGORY` `TARGETING_TYPE_CHANNEL` `TARGETING_TYPE_DEVICE_MAKE_MODEL` `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION` `TARGETING_TYPE_ENVIRONMENT` `TARGETING_TYPE_GENDER` `TARGETING_TYPE_KEYWORD` `TARGETING_TYPE_LANGUAGE` `TARGETING_TYPE_NEGATIVE_KEYWORD_LIST` `TARGETING_TYPE_OPERATING_SYSTEM` `TARGETING_TYPE_PARENTAL_STATUS` `TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION` `TARGETING_TYPE_VIEWABILITY`

advertiserId

string (int64 format)

Required. The ID of the advertiser the insertion order belongs to.

insertionOrderId

string (int64 format)

Required. The ID of the insertion order the assigned targeting option will belong to.

targetingType

enum (TargetingType)

Required. Identifies the type of this assigned targeting option.

Supported targeting types:

Request body

The request body contains an instance of AssignedTargetingOption.

Response body

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

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.