Method: advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.create

AI-generated Key Takeaways

• This page details how to assign a targeting option to an insertion order using a POST request.

• The request requires specifying the advertiser ID, insertion order ID, and the type of targeting in the path parameters.

• A list of supported targeting types, such as age range, browser, and gender, is provided.

• The request and response bodies both contain an instance of AssignedTargetingOption.

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

• 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:

• 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

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path 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

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.