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: targetingTypes.targetingOptions.get

AI-generated Key Takeaways

Retrieves a single targeting option based on its ID and type.
Requires specifying the targeting type, targeting option ID, and advertiser ID.
Uses an HTTP GET request with path and query parameters.
An empty request body is needed and a successful response returns a TargetingOption object.
Authorization with the https://www.googleapis.com/auth/display-video scope is necessary.

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

Gets a single targeting option.

HTTP request

GET https://displayvideo.googleapis.com/v3/targetingTypes/{targetingType}/targetingOptions/{targetingOptionId}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters

Parameters
`targetingType`	`enum (TargetingType)` Required. The type of targeting option to retrieve. Accepted values are: `TARGETING_TYPE_APP_CATEGORY` `TARGETING_TYPE_AGE_RANGE` `TARGETING_TYPE_GENDER` `TARGETING_TYPE_VIDEO_PLAYER_SIZE` `TARGETING_TYPE_USER_REWARDED_CONTENT` `TARGETING_TYPE_PARENTAL_STATUS` `TARGETING_TYPE_CONTENT_INSTREAM_POSITION` `TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION` `TARGETING_TYPE_DEVICE_TYPE` `TARGETING_TYPE_BROWSER` `TARGETING_TYPE_HOUSEHOLD_INCOME` `TARGETING_TYPE_ON_SCREEN_POSITION` `TARGETING_TYPE_CARRIER_AND_ISP` `TARGETING_TYPE_OPERATING_SYSTEM` `TARGETING_TYPE_DEVICE_MAKE_MODEL` `TARGETING_TYPE_ENVIRONMENT` `TARGETING_TYPE_CATEGORY` `TARGETING_TYPE_VIEWABILITY` `TARGETING_TYPE_AUTHORIZED_SELLER_STATUS` `TARGETING_TYPE_LANGUAGE` `TARGETING_TYPE_GEO_REGION` `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION` `TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION` `TARGETING_TYPE_EXCHANGE` `TARGETING_TYPE_SUB_EXCHANGE` `TARGETING_TYPE_NATIVE_CONTENT_POSITION` `TARGETING_TYPE_OMID`
`targetingOptionId`	`string` Required. The ID of the of targeting option to retrieve.

targetingType

enum (TargetingType)

Required. The type of targeting option to retrieve.

Accepted values are:

TARGETING_TYPE_APP_CATEGORY
TARGETING_TYPE_AGE_RANGE
TARGETING_TYPE_GENDER
TARGETING_TYPE_VIDEO_PLAYER_SIZE
TARGETING_TYPE_USER_REWARDED_CONTENT
TARGETING_TYPE_PARENTAL_STATUS
TARGETING_TYPE_CONTENT_INSTREAM_POSITION
TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
TARGETING_TYPE_DEVICE_TYPE
TARGETING_TYPE_BROWSER
TARGETING_TYPE_HOUSEHOLD_INCOME
TARGETING_TYPE_ON_SCREEN_POSITION
TARGETING_TYPE_CARRIER_AND_ISP
TARGETING_TYPE_OPERATING_SYSTEM
TARGETING_TYPE_DEVICE_MAKE_MODEL
TARGETING_TYPE_ENVIRONMENT
TARGETING_TYPE_CATEGORY
TARGETING_TYPE_VIEWABILITY
TARGETING_TYPE_AUTHORIZED_SELLER_STATUS
TARGETING_TYPE_LANGUAGE
TARGETING_TYPE_GEO_REGION
TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
TARGETING_TYPE_EXCHANGE
TARGETING_TYPE_SUB_EXCHANGE
TARGETING_TYPE_NATIVE_CONTENT_POSITION
TARGETING_TYPE_OMID

targetingOptionId

string

Required. The ID of the of targeting option to retrieve.

Query parameters

Parameters

Parameters
`advertiserId`	`string (int64 format)` Required. The Advertiser this request is being made in the context of.

advertiserId

string (int64 format)

Required. The Advertiser this request is being made in the context of.

Request body

The request body must be empty.

Response body

If successful, the response body contains an instance of TargetingOption.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.