Method: advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.create

AI-generated Key Takeaways

• Display & Video 360 API v3 has sunset and users should transition to v4.

• This page describes how to assign a targeting option to an insertion order using the v3 API, returning the assigned targeting option upon success.

• The API supports various targeting types including age range, browser, category, channel, and device make/model.

• The request is made via a POST HTTP request to a specific URL format including advertiser ID, insertion order ID, and targeting type as path parameters.

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

Display & Video 360 API v3 has sunset. Use v4 instead.

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