Method: advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.create

AI-generated Key Takeaways

• Display & Video 360 API v2 has sunset.

• This content explains how to assign a targeting option to an insertion order and retrieve the assigned option if successful.

• It lists the supported targeting types, including age range, browser, category, channel, device make/model, and others.

• The HTTP request method is POST, with path parameters for advertiserId, insertionOrderId, and targetingType.

• The request and response bodies contain an instance of AssignedTargetingOption, and the authorization scope required is https://www.googleapis.com/auth/display-video.

Display & Video 360 API v2 has sunset.

• 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/v2/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.