create(advertiserId, lineItemId, targetingType, body=None, x__xgafv=None)
Assigns a targeting option to a line item.
delete(advertiserId, lineItemId, targetingType, assignedTargetingOptionId, x__xgafv=None)
Deletes an assigned targeting option from a line item.
get(advertiserId, lineItemId, targetingType, assignedTargetingOptionId, x__xgafv=None)
Gets a single targeting option assigned to a line item.
Lists the targeting options assigned to a line item.
list_next(previous_request, previous_response)
Retrieves the next page of results.
create(advertiserId, lineItemId, targetingType, body=None, x__xgafv=None)
Assigns a targeting option to a line item.
Returns the assigned targeting option if successful.
Args:
advertiserId: string, Required. The ID of the advertiser the line item belongs to. (required)
lineItemId: string, Required. The ID of the line item the assigned targeting option will belong to. (required)
targetingType: string, Required. Identifies the type of this assigned targeting option. (required)
body: object, The request body.
The object takes the form of:
{ # A single assigned targeting option, which defines the state of a targeting
# option for an entity with targeting settings, such as a Line Item or
# Insertion Order.
"appDetails": { # Details for assigned app targeting option. This will be populated in the # App details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_APP`.
# details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_APP`.
"displayName": "A String", # Output only. The display name of the app.
"appId": "A String", # Required. The ID of the app.
#
# Android's Play store app uses bundle ID, for example
# `com.google.android.gm`. Apple's App store app ID uses 9 digit string, for
# example `422689480`.
"negative": True or False, # Indicates if this option is being negatively targeted.
},
"parentalStatusDetails": { # Details for assigned parental status targeting option. This will be # Parental status details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_PARENTAL_STATUS`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARTGETING_TYPE_PARENTAL_STATUS`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_PARENTAL_STATUS`.
"parentalStatus": "A String", # Output only. The parental status of the audience.
},
"targetingType": "A String", # Output only. Identifies the type of this assigned targeting option.
"urlDetails": { # Details for assigned URL targeting option. This will be populated in the # URL details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_URL`.
# details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_URL`.
"url": "A String", # Required. The URL, for example `example.com`.
#
# DV360 supports two levels of subdirectory targeting, for example
# `www.example.com/one-subdirectory-level/second-level`, and five levels of
# subdomain targeting, for example `five.four.three.two.one.example.com`.
"negative": True or False, # Indicates if this option is being negatively targeted.
},
"onScreenPositionDetails": { # On screen position targeting option details. This will be # On screen position details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_ON_SCREEN_POSITION`.
# populated in the
# on_screen_position_details
# field when
# targeting_type is
# `TARGETING_TYPE_ON_SCREEN_POSITION`.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_ON_SCREEN_POSITION`.
"onScreenPosition": "A String", # Output only. The on screen position.
},
"videoPlayerSizeDetails": { # Video player size targeting option details. This will be populated in the # Video player size details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_VIDEO_PLAYER_SIZE`.
# video_player_size_details
# field when targeting_type is
# `TARGETING_TYPE_VIDEO_PLAYER_SIZE`.
# Explicitly targeting all options is not supported. Remove all video player
# size targeting options to achieve this effect.
"videoPlayerSize": "A String", # Output only. The video player size.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_VIDEO_PLAYER_SIZE`.
},
"channelDetails": { # Details for assigned channel targeting option. This will be populated in # Channel details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_CHANNEL`.
# the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_CHANNEL`.
"channelId": "A String", # Required. ID of the channel. Should refer to the channel ID
# field on a
# [Partner-owned channel](partners.channels#Channel.FIELDS.channel_id) or
# [advertiser-owned channel](advertisers.channels#Channel.FIELDS.channel_id)
# resource.
"negative": True or False, # Indicates if this option is being negatively targeted. For advertiser
# level assigned targeting option, this field must be true.
},
"operatingSystemDetails": { # Assigned operating system targeting option details. This will be # Operating system details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_OPERATING_SYSTEM`.
# populated in the
# operating_system_details
# field when
# targeting_type is
# `TARGETING_TYPE_OPERATING_SYSTEM`.
"displayName": "A String", # Output only. The display name of the operating system.
"negative": True or False, # Indicates if this option is being negatively targeted.
"targetingOptionId": "A String", # Required. The targeting option ID populated in
# targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_OPERATING_SYSTEM`.
},
"thirdPartyVerifierDetails": { # Assigned third party verifier targeting option details. This will be # Third party verification details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_THIRD_PARTY_VERIFIER`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_THIRD_PARTY_VERIFIER`.
"integralAdScience": { # Details of Integral Ad Science settings. # Third party brand verifier -- Integral Ad Science.
"excludedAdFraudRisk": "A String", # Ad Fraud settings.
"displayViewability": "A String", # Display Viewability section (applicable to display line items only).
"excludedHateSpeechRisk": "A String", # Brand Safety - **Hate speech**.
"excludedOffensiveLanguageRisk": "A String", # Brand Safety - **Offensive language**.
"excludedDrugsRisk": "A String", # Brand Safety - **Drugs**.
"excludedAdultRisk": "A String", # Brand Safety - **Adult content**.
"traqScoreOption": "A String", # True advertising quality (applicable to Display line items only).
"videoViewability": "A String", # Video Viewability Section (applicable to video line items only).
"excludedAlcoholRisk": "A String", # Brand Safety - **Alcohol**.
"excludedGamblingRisk": "A String", # Brand Safety - **Gambling**.
"excludeUnrateable": True or False, # Brand Safety - **Unrateable**.
"excludedIllegalDownloadsRisk": "A String", # Brand Safety - **Illegal downloads**.
"excludedViolenceRisk": "A String", # Brand Safety - **Violence**.
},
"doubleVerify": { # Details of DoubleVerify settings. # Third party brand verifier -- DoubleVerify.
"videoViewability": { # Details of DoubleVerify video viewability settings. # Video viewability settings (applicable to video line items only).
"playerImpressionRate": "A String", # Target inventory to maximize impressions with 400x300 or greater player
# size.
"videoIab": "A String", # Target web inventory to maximize IAB viewable rate.
"videoViewableRate": "A String", # Target web inventory to maximize fully viewable rate.
},
"avoidedAgeRatings": [ # Avoid bidding on apps with the age rating.
"A String",
],
"fraudInvalidTraffic": { # DoubleVerify Fraud & Invalid Traffic settings. # Avoid Sites and Apps with historical Fraud & IVT Rates.
"avoidInsufficientOption": True or False, # Insufficient Historical Fraud & IVT Stats.
"avoidedFraudOption": "A String", # Avoid Sites and Apps with historical Fraud & IVT.
},
"brandSafetyCategories": { # Settings for brand safety controls. # DV Brand Safety Controls.
"avoidedMediumSeverityCategories": [ # Brand safety medium severity avoidance categories.
"A String",
],
"avoidedHighSeverityCategories": [ # Brand safety high severity avoidance categories.
"A String",
],
"avoidUnknownBrandSafetyCategory": True or False, # Unknown or unrateable.
},
"appStarRating": { # Details of DoubleVerify star ratings settings. # Avoid bidding on apps with the star ratings.
"avoidedStarRating": "A String", # Avoid bidding on apps with the star ratings.
"avoidInsufficientStarRating": True or False, # Avoid bidding on apps with insufficient star ratings.
},
"displayViewability": { # Details of DoubleVerify display viewability settings. # Display viewability settings (applicable to display line items only).
"viewableDuring": "A String", # Target web and app inventory to maximize 100% viewable duration.
"iab": "A String", # Target web and app inventory to maximize IAB viewable rate.
},
},
"adloox": { # Details of Adloox settings. # Third party brand verifier -- Adloox.
"excludedAdlooxCategories": [ # Adloox's brand safety settings.
"A String",
],
},
},
"proximityLocationListDetails": { # Targeting details for proximity location list. This will be # Proximity location list details. This field will be populated when the
# TargetingType is
# `TARGETING_TYPE_PROXIMITY_LOCATION_LIST`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_PROXIMITY_LOCATION_LIST`.
"proximityRadiusRange": "A String", # Required. Radius range for proximity location list.
# This represents the size of the area around a chosen location that will be
# targeted.
#
# `All` proximity location targeting under a single line item must have the
# same radius range value. Set this value to match any existing targeting.
# If updated, this field will change the radius range for all proximity
# targeting under the line item.
"proximityLocationListId": "A String", # Required. ID of the proximity location list. Should refer to the
# location_list_id field of a
# LocationList resource whose type is
# `TARGETING_LOCATION_TYPE_PROXIMITY`.
},
"ageRangeDetails": { # Represents a targetable age range. This will be populated in the details # Age range details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_AGE_RANGE`.
# field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_AGE_RANGE`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_AGE_RANGE`.
"ageRange": "A String", # Output only. The age range of an audience. We only support targeting a continuous age
# range of an audience. Thus, the age range represented in this field can be
# 1) targeted solely, or, 2) part of a larger continuous age range. The reach
# of a continuous age range targeting can be expanded by also targeting an
# audience of an unknown age.
},
"subExchangeDetails": { # Details for assigned sub-exchange targeting option. This will be populated in # Sub-exchange details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_SUB_EXCHANGE`.
# the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_SUB_EXCHANGE`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_SUB_EXCHANGE`.
},
"keywordDetails": { # Details for assigned keyword targeting option. This will be populated in the # Keyword details. This field will be populated when the TargetingType is
# `TARGETING_TYPE_KEYWORD`.
#
# A maximum of 5000 direct negative keywords can be assigned to a
# line item. No limit on number of positive keywords that can be assigned.
# details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_KEYWORD`.
"negative": True or False, # Indicates if this option is being negatively targeted.
"keyword": "A String", # Required. The keyword, for example `car insurance`.
#
# Positive keyword cannot be offensive word.
# Must be UTF-8 encoded with a maximum size of 255 bytes. Maximum number
# of characters is 80. Maximum number of words is 10.
},
"deviceMakeModelDetails": { # Assigned device make and model targeting option details. This will be # Device make and model details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_DEVICE_MAKE_MODEL`.
# populated in the
# device_make_model_details
# field when
# targeting_type is
# `TARGETING_TYPE_DEVICE_MAKE_MODEL`.
"negative": True or False, # Indicates if this option is being negatively targeted.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_DEVICE_MAKE_MODEL`.
"displayName": "A String", # Output only. The display name of the device make and model.
},
"digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be # Digital content label details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`.
#
# Digital content labels are targeting exclusions. Advertiser level digital
# content label exclusions, if set, are always applied in serving (even
# though they aren't visible in line item settings). Line item settings can
# exclude content labels in addition to advertiser exclusions, but can't
# override them. A line item won't serve if all the digital content labels
# are excluded.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`.
"excludedTargetingOptionId": "A String", # Required. ID of the digital content label to be EXCLUDED.
"contentRatingTier": "A String", # Output only. The display name of the digital content label rating tier.
},
"browserDetails": { # Details for assigned browser targeting option. This will be populated in # Browser details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_BROWSER`.
# the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_BROWSER`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_BROWSER`.
"displayName": "A String", # Output only. The display name of the browser.
"negative": True or False, # Indicates if this option is being negatively targeted. All assigned browser
# targeting options on the same line item must have the same value for this
# field.
},
"appCategoryDetails": { # Details for assigned app category targeting option. This will be # App category details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_APP_CATEGORY`.
# populated in the
# app_category_details field of
# an AssignedTargetingOption when
# targeting_type
# is `TARGETING_TYPE_APP_CATEGORY`.
"negative": True or False, # Indicates if this option is being negatively targeted.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_APP_CATEGORY`.
"displayName": "A String", # Output only. The display name of the app category.
},
"contentOutstreamPositionDetails": { # Assigned content outstream position targeting option details. This will be # Content outstream position details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION`.
# populated in the
# content_outstream_position_details
# field when
# targeting_type is
# `TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION`.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION`.
"contentOutstreamPosition": "A String", # Output only. The content outstream position.
},
"negativeKeywordListDetails": { # Targeting details for negative keyword list. This will be populated in the # Keyword details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_NEGATIVE_KEYWORD_LIST`.
#
# A maximum of 4 negative keyword lists can be assigned to a line item.
# details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_NEGATIVE_KEYWORD_LIST`.
"negativeKeywordListId": "A String", # Required. ID of the negative keyword list. Should refer to the
# negative_keyword_list_id
# field of a NegativeKeywordList resource.
},
"genderDetails": { # Details for assigned gender targeting option. This will be populated in # Gender details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_GENDER`.
# the details field of an AssignedTargetingOption when
# targeting_type is
# `TARTGETING_TYPE_GENDER`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_GENDER`.
"gender": "A String", # Output only. The gender of the audience.
},
"name": "A String", # Output only. The resource name for this assigned targeting option.
"inventorySourceDetails": { # Targeting details for inventory source. This will be # Inventory source details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_INVENTORY_SOURCE`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_INVENTORY_SOURCE`.
"inventorySourceId": "A String", # Required. ID of the inventory source. Should refer to the
# inventory_source_id field of an
# InventorySource resource.
},
"sensitiveCategoryExclusionDetails": { # Targeting details for sensitive category. This will be populated in the # Sensitive category details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION`.
#
# Sensitive categories are targeting exclusions. Advertiser level sensitive
# category exclusions, if set, are always applied in serving (even though
# they aren't visible in line item settings). Line item settings can
# exclude sensitive categories in addition to advertiser exclusions, but
# can't override them.
# details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION`.
"excludedTargetingOptionId": "A String", # Required. ID of the sensitive category to be EXCLUDED.
"sensitiveCategory": "A String", # Output only. An enum for the DV360 Sensitive category content classifier.
},
"audienceGroupDetails": { # Assigned audience group targeting option details. This will be populated in # Audience targeting details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_AUDIENCE_GROUP`.
# You can only target one audience group option per line item.
# the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_AUDIENCE_GROUP`.
# The relation between each group is UNION, except for
# excluded_first_and_third_party_audience_group and
# excluded_google_audience_group, of which COMPLEMENT is UNION'ed with other
# groups.
"includedFirstAndThirdPartyAudienceGroups": [ # The first and third party audience ids and recencies of included first
# and third party audience groups. Each first and third party audience group
# contains first and third party audience ids only.
# The relation between each first and third party audience group is
# INTERSECTION, and the result is UNION'ed with other audience groups.
# Repeated groups with same settings will be ignored.
{ # Details of first and third party audience group.
# All first and third party audience targeting settings are logically ‘OR’ of
# each other.
"settings": [ # Required. All first and third party audience targeting settings in first and
# third party audience group.
# Repeated settings with same id are not allowed.
{ # Details of first and third party audience targeting setting.
"recency": "A String", # The recency of the first and third party audience targeting setting.
# Only applicable to first party audiences, otherwise
# will be ignored. For more info, refer to
# https://support.google.com/displayvideo/answer/2949947#recency
# When unspecified, no recency limit will be used.
"firstAndThirdPartyAudienceId": "A String", # Required. First and third party audience id of the first and third party audience
# targeting setting. This id is
# first_and_third_party_audience_id.
},
],
},
],
"includedCombinedAudienceGroup": { # Details of combined audience group. # The combined audience ids of the included combined audience group.
# Contains combined audience ids only.
# All combined audience targeting settings are logically ‘OR’ of each other.
"settings": [ # Required. All combined audience targeting settings in combined audience group.
# Repeated settings with same id will be ignored.
# The number of combined audience settings should be no more than five, error
# will be thrown otherwise.
{ # Details of combined audience targeting setting.
"combinedAudienceId": "A String", # Required. Combined audience id of combined audience targeting setting.
# This id is combined_audience_id.
},
],
},
"includedCustomListGroup": { # Details of custom list group. # The custom list ids of the included custom list group.
# Contains custom list ids only.
# All custom list targeting settings are logically ‘OR’ of each other.
"settings": [ # Required. All custom list targeting settings in custom list group.
# Repeated settings with same id will be ignored.
{ # Details of custom list targeting setting.
"customListId": "A String", # Required. Custom id of custom list targeting setting.
# This id is custom_list_id.
},
],
},
"excludedFirstAndThirdPartyAudienceGroup": { # Details of first and third party audience group. # The first and third party audience ids and recencies of the excluded
# first and third party audience group. Used for negative targeting. Its
# COMPLEMENT is used to UNION other audience groups.
# All first and third party audience targeting settings are logically ‘OR’ of
# each other.
"settings": [ # Required. All first and third party audience targeting settings in first and
# third party audience group.
# Repeated settings with same id are not allowed.
{ # Details of first and third party audience targeting setting.
"recency": "A String", # The recency of the first and third party audience targeting setting.
# Only applicable to first party audiences, otherwise
# will be ignored. For more info, refer to
# https://support.google.com/displayvideo/answer/2949947#recency
# When unspecified, no recency limit will be used.
"firstAndThirdPartyAudienceId": "A String", # Required. First and third party audience id of the first and third party audience
# targeting setting. This id is
# first_and_third_party_audience_id.
},
],
},
"includedGoogleAudienceGroup": { # Details of Google audience group. # The Google audience ids of the included Google audience group.
# Contains Google audience ids only.
# All Google audience targeting settings are logically ‘OR’ of each other.
"settings": [ # Required. All Google audience targeting settings in Google audience group.
# Repeated settings with same id will be ignored.
{ # Details of Google audience targeting setting.
"googleAudienceId": "A String", # Required. Google audience id of the Google audience targeting setting.
# This id is google_audience_id.
},
],
},
"excludedGoogleAudienceGroup": { # Details of Google audience group. # The Google audience ids of the excluded Google audience group.
# Used for negative targeting. It's COMPLEMENT is used to UNION other
# audience groups.
# Only contains Affinity, In-market and Installed-apps type Google audiences.
# All items are logically ‘OR’ of each other.
# All Google audience targeting settings are logically ‘OR’ of each other.
"settings": [ # Required. All Google audience targeting settings in Google audience group.
# Repeated settings with same id will be ignored.
{ # Details of Google audience targeting setting.
"googleAudienceId": "A String", # Required. Google audience id of the Google audience targeting setting.
# This id is google_audience_id.
},
],
},
},
"userRewardedContentDetails": { # User rewarded content targeting option details. This will be populated in # User rewarded content details. This field will be populated when the
# TargetingType is
# `TARGETING_TYPE_USER_REWARDED_CONTENT`.
# the
# user_rewarded_content_details
# field when
# targeting_type is
# `TARGETING_TYPE_USER_REWARDED_CONTENT`.
"userRewardedContent": "A String", # Output only. User rewarded content status for video ads.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_USER_REWARDED_CONTENT`.
},
"languageDetails": { # Details for assigned language targeting option. This will be populated in the # Language details. This field will be populated when the TargetingType is
# `TARGETING_TYPE_LANGUAGE`.
# details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_LANGUAGE`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_LANGUAGE`.
"displayName": "A String", # Output only. The display name of the language (e.g., "French").
"negative": True or False, # Indicates if this option is being negatively targeted. All assigned
# language targeting options on the same line item must have the same value
# for this field.
},
"authorizedSellerStatusDetails": { # Represents an assigned authorized seller status. This will be populated in # Authorized seller status details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_AUTHORIZED_SELLER_STATUS`.
#
# You can only target one authorized seller status option per line item.
#
# If a line item doesn't have an authorized seller status option, all
# authorized sellers indicated as DIRECT or RESELLER in the ads.txt file
# are targeted by default.
# the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_AUTHORIZED_SELLER_STATUS`.
"authorizedSellerStatus": "A String", # Output only. The authorized seller status to target.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_AUTHORIZED_SELLER_STATUS`.
},
"dayAndTimeDetails": { # Representation of a segment of time defined on a specific day of the week and # Day and time details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_DAY_AND_TIME`.
# with a start and end time.
# The time represented by `start_hour` must be before the time represented by
# `end_hour`.
"dayOfWeek": "A String", # Required. The day of the week for this day and time targeting setting.
"startHour": 42, # Required. The start hour for day and time targeting. Must be between 0 (start of day)
# and 23 (1 hour before end of day).
"endHour": 42, # Required. The end hour for day and time targeting. Must be between 1 (1 hour after
# start of day) and 24 (end of day).
"timeZoneResolution": "A String", # Required. The mechanism used to determine which timezone to use for this day and time
# targeting setting.
},
"inheritance": "A String", # Output only. The inheritance status of the assigned targeting option.
"environmentDetails": { # Assigned environment targeting option details. This will be populated # Environment details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_ENVIRONMENT`.
# in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_ENVIRONMENT`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_ENVIRONMENT` (e.g., "508010"
# for targeting the `ENVIRONMENT_WEB_OPTIMIZED` option).
"environment": "A String", # Output only. The serving environment.
},
"geoRegionDetails": { # Details for assigned geographic region targeting option. This will be # Geographic region details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_GEO_REGION`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_GEO_REGION`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_GEO_REGION`.
"displayName": "A String", # Output only. The display name of the geographic region (e.g., "Ontario, Canada").
"geoRegionType": "A String", # Output only. The type of geographic region targeting.
"negative": True or False, # Indicates if this option is being negatively targeted.
},
"deviceTypeDetails": { # Targeting details for device type. This will be # Device Type details. This field will be populated when the
# TargetingType is
# `TARGETING_TYPE_DEVICE_TYPE`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_DEVICE_TYPE`.
"targetingOptionId": "A String", # Required. ID of the device type.
"deviceType": "A String", # Output only. The display name of the device type.
},
"exchangeDetails": { # Details for assigned exchange targeting option. This will be populated in # Exchange details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_EXCHANGE`.
# the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_EXCHANGE`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_EXCHANGE`.
},
"assignedTargetingOptionId": "A String", # Output only. The unique ID of the assigned targeting option. The ID is only unique
# within a given line item and targeting type. It may be reused in other
# contexts.
"householdIncomeDetails": { # Details for assigned household income targeting option. This will be # Household income details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_HOUSEHOLD_INCOME`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_HOUSEHOLD_INCOME`.
"householdIncome": "A String", # Output only. The household income of the audience.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_HOUSEHOLD_INCOME`.
},
"contentInstreamPositionDetails": { # Assigned content instream position targeting option details. This will be # Content instream position details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_CONTENT_INSTREAM_POSITION`.
# populated in the
# content_instream_position_details
# field when
# targeting_type is
# `TARGETING_TYPE_CONTENT_INSTREAM_POSITION`.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_CONTENT_INSTREAM_POSITION`.
"contentInstreamPosition": "A String", # Output only. The content instream position for video or audio ads.
},
"categoryDetails": { # Assigned category targeting option details. This will be populated in the # Category details. This field will be populated when the TargetingType is
# `TARGETING_TYPE_CATEGORY`.
#
# Targeting a category will also target its subcategories. If a category is
# excluded from targeting and a subcategory is included, the exclusion will
# take precedence.
# category_details field when
# targeting_type is
# `TARGETING_TYPE_CATEGORY`.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_CATEGORY`.
"displayName": "A String", # Output only. The display name of the category.
"negative": True or False, # Indicates if this option is being negatively targeted.
},
"inventorySourceGroupDetails": { # Targeting details for inventory source group. This will be # Inventory source group details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_INVENTORY_SOURCE_GROUP`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_INVENTORY_SOURCE_GROUP`.
"inventorySourceGroupId": "A String", # Required. ID of the inventory source group. Should refer to the
# inventory_source_group_id
# field of an InventorySourceGroup resource.
},
"regionalLocationListDetails": { # Targeting details for regional location list. This will be # Regional location list details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_REGIONAL_LOCATION_LIST`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_REGIONAL_LOCATION_LIST`.
"regionalLocationListId": "A String", # Required. ID of the regional location list. Should refer to the
# location_list_id field of a
# LocationList resource whose type is `TARGETING_LOCATION_TYPE_REGIONAL`.
"negative": True or False, # Indicates if this option is being negatively targeted.
},
"carrierAndIspDetails": { # Details for assigned carrier and ISP targeting option. This will be populated # Carrier and ISP details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_CARRIER_AND_ISP`.
# in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_CARRIER_AND_ISP`.
"negative": True or False, # Indicates if this option is being negatively targeted. All assigned carrier
# and ISP targeting options on the same line item must have the same value
# for this field.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_CARRIER_AND_ISP`.
"displayName": "A String", # Output only. The display name of the carrier or ISP.
},
"viewabilityDetails": { # Assigned viewability targeting option details. This will be populated in the # Viewability details. This field will be populated when the TargetingType
# is `TARGETING_TYPE_VIEWABILITY`.
#
# You can only target one viewability option per line item.
# viewability_details field of
# an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_VIEWABILITY`.
"viewability": "A String", # Output only. The predicted viewability percentage.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_VIEWABILITY` (e.g., "509010"
# for targeting the `VIEWABILITY_10_PERCENT_OR_MORE` option).
},
}
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # A single assigned targeting option, which defines the state of a targeting
# option for an entity with targeting settings, such as a Line Item or
# Insertion Order.
"appDetails": { # Details for assigned app targeting option. This will be populated in the # App details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_APP`.
# details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_APP`.
"displayName": "A String", # Output only. The display name of the app.
"appId": "A String", # Required. The ID of the app.
#
# Android's Play store app uses bundle ID, for example
# `com.google.android.gm`. Apple's App store app ID uses 9 digit string, for
# example `422689480`.
"negative": True or False, # Indicates if this option is being negatively targeted.
},
"parentalStatusDetails": { # Details for assigned parental status targeting option. This will be # Parental status details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_PARENTAL_STATUS`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARTGETING_TYPE_PARENTAL_STATUS`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_PARENTAL_STATUS`.
"parentalStatus": "A String", # Output only. The parental status of the audience.
},
"targetingType": "A String", # Output only. Identifies the type of this assigned targeting option.
"urlDetails": { # Details for assigned URL targeting option. This will be populated in the # URL details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_URL`.
# details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_URL`.
"url": "A String", # Required. The URL, for example `example.com`.
#
# DV360 supports two levels of subdirectory targeting, for example
# `www.example.com/one-subdirectory-level/second-level`, and five levels of
# subdomain targeting, for example `five.four.three.two.one.example.com`.
"negative": True or False, # Indicates if this option is being negatively targeted.
},
"onScreenPositionDetails": { # On screen position targeting option details. This will be # On screen position details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_ON_SCREEN_POSITION`.
# populated in the
# on_screen_position_details
# field when
# targeting_type is
# `TARGETING_TYPE_ON_SCREEN_POSITION`.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_ON_SCREEN_POSITION`.
"onScreenPosition": "A String", # Output only. The on screen position.
},
"videoPlayerSizeDetails": { # Video player size targeting option details. This will be populated in the # Video player size details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_VIDEO_PLAYER_SIZE`.
# video_player_size_details
# field when targeting_type is
# `TARGETING_TYPE_VIDEO_PLAYER_SIZE`.
# Explicitly targeting all options is not supported. Remove all video player
# size targeting options to achieve this effect.
"videoPlayerSize": "A String", # Output only. The video player size.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_VIDEO_PLAYER_SIZE`.
},
"channelDetails": { # Details for assigned channel targeting option. This will be populated in # Channel details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_CHANNEL`.
# the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_CHANNEL`.
"channelId": "A String", # Required. ID of the channel. Should refer to the channel ID
# field on a
# [Partner-owned channel](partners.channels#Channel.FIELDS.channel_id) or
# [advertiser-owned channel](advertisers.channels#Channel.FIELDS.channel_id)
# resource.
"negative": True or False, # Indicates if this option is being negatively targeted. For advertiser
# level assigned targeting option, this field must be true.
},
"operatingSystemDetails": { # Assigned operating system targeting option details. This will be # Operating system details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_OPERATING_SYSTEM`.
# populated in the
# operating_system_details
# field when
# targeting_type is
# `TARGETING_TYPE_OPERATING_SYSTEM`.
"displayName": "A String", # Output only. The display name of the operating system.
"negative": True or False, # Indicates if this option is being negatively targeted.
"targetingOptionId": "A String", # Required. The targeting option ID populated in
# targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_OPERATING_SYSTEM`.
},
"thirdPartyVerifierDetails": { # Assigned third party verifier targeting option details. This will be # Third party verification details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_THIRD_PARTY_VERIFIER`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_THIRD_PARTY_VERIFIER`.
"integralAdScience": { # Details of Integral Ad Science settings. # Third party brand verifier -- Integral Ad Science.
"excludedAdFraudRisk": "A String", # Ad Fraud settings.
"displayViewability": "A String", # Display Viewability section (applicable to display line items only).
"excludedHateSpeechRisk": "A String", # Brand Safety - **Hate speech**.
"excludedOffensiveLanguageRisk": "A String", # Brand Safety - **Offensive language**.
"excludedDrugsRisk": "A String", # Brand Safety - **Drugs**.
"excludedAdultRisk": "A String", # Brand Safety - **Adult content**.
"traqScoreOption": "A String", # True advertising quality (applicable to Display line items only).
"videoViewability": "A String", # Video Viewability Section (applicable to video line items only).
"excludedAlcoholRisk": "A String", # Brand Safety - **Alcohol**.
"excludedGamblingRisk": "A String", # Brand Safety - **Gambling**.
"excludeUnrateable": True or False, # Brand Safety - **Unrateable**.
"excludedIllegalDownloadsRisk": "A String", # Brand Safety - **Illegal downloads**.
"excludedViolenceRisk": "A String", # Brand Safety - **Violence**.
},
"doubleVerify": { # Details of DoubleVerify settings. # Third party brand verifier -- DoubleVerify.
"videoViewability": { # Details of DoubleVerify video viewability settings. # Video viewability settings (applicable to video line items only).
"playerImpressionRate": "A String", # Target inventory to maximize impressions with 400x300 or greater player
# size.
"videoIab": "A String", # Target web inventory to maximize IAB viewable rate.
"videoViewableRate": "A String", # Target web inventory to maximize fully viewable rate.
},
"avoidedAgeRatings": [ # Avoid bidding on apps with the age rating.
"A String",
],
"fraudInvalidTraffic": { # DoubleVerify Fraud & Invalid Traffic settings. # Avoid Sites and Apps with historical Fraud & IVT Rates.
"avoidInsufficientOption": True or False, # Insufficient Historical Fraud & IVT Stats.
"avoidedFraudOption": "A String", # Avoid Sites and Apps with historical Fraud & IVT.
},
"brandSafetyCategories": { # Settings for brand safety controls. # DV Brand Safety Controls.
"avoidedMediumSeverityCategories": [ # Brand safety medium severity avoidance categories.
"A String",
],
"avoidedHighSeverityCategories": [ # Brand safety high severity avoidance categories.
"A String",
],
"avoidUnknownBrandSafetyCategory": True or False, # Unknown or unrateable.
},
"appStarRating": { # Details of DoubleVerify star ratings settings. # Avoid bidding on apps with the star ratings.
"avoidedStarRating": "A String", # Avoid bidding on apps with the star ratings.
"avoidInsufficientStarRating": True or False, # Avoid bidding on apps with insufficient star ratings.
},
"displayViewability": { # Details of DoubleVerify display viewability settings. # Display viewability settings (applicable to display line items only).
"viewableDuring": "A String", # Target web and app inventory to maximize 100% viewable duration.
"iab": "A String", # Target web and app inventory to maximize IAB viewable rate.
},
},
"adloox": { # Details of Adloox settings. # Third party brand verifier -- Adloox.
"excludedAdlooxCategories": [ # Adloox's brand safety settings.
"A String",
],
},
},
"proximityLocationListDetails": { # Targeting details for proximity location list. This will be # Proximity location list details. This field will be populated when the
# TargetingType is
# `TARGETING_TYPE_PROXIMITY_LOCATION_LIST`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_PROXIMITY_LOCATION_LIST`.
"proximityRadiusRange": "A String", # Required. Radius range for proximity location list.
# This represents the size of the area around a chosen location that will be
# targeted.
#
# `All` proximity location targeting under a single line item must have the
# same radius range value. Set this value to match any existing targeting.
# If updated, this field will change the radius range for all proximity
# targeting under the line item.
"proximityLocationListId": "A String", # Required. ID of the proximity location list. Should refer to the
# location_list_id field of a
# LocationList resource whose type is
# `TARGETING_LOCATION_TYPE_PROXIMITY`.
},
"ageRangeDetails": { # Represents a targetable age range. This will be populated in the details # Age range details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_AGE_RANGE`.
# field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_AGE_RANGE`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_AGE_RANGE`.
"ageRange": "A String", # Output only. The age range of an audience. We only support targeting a continuous age
# range of an audience. Thus, the age range represented in this field can be
# 1) targeted solely, or, 2) part of a larger continuous age range. The reach
# of a continuous age range targeting can be expanded by also targeting an
# audience of an unknown age.
},
"subExchangeDetails": { # Details for assigned sub-exchange targeting option. This will be populated in # Sub-exchange details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_SUB_EXCHANGE`.
# the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_SUB_EXCHANGE`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_SUB_EXCHANGE`.
},
"keywordDetails": { # Details for assigned keyword targeting option. This will be populated in the # Keyword details. This field will be populated when the TargetingType is
# `TARGETING_TYPE_KEYWORD`.
#
# A maximum of 5000 direct negative keywords can be assigned to a
# line item. No limit on number of positive keywords that can be assigned.
# details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_KEYWORD`.
"negative": True or False, # Indicates if this option is being negatively targeted.
"keyword": "A String", # Required. The keyword, for example `car insurance`.
#
# Positive keyword cannot be offensive word.
# Must be UTF-8 encoded with a maximum size of 255 bytes. Maximum number
# of characters is 80. Maximum number of words is 10.
},
"deviceMakeModelDetails": { # Assigned device make and model targeting option details. This will be # Device make and model details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_DEVICE_MAKE_MODEL`.
# populated in the
# device_make_model_details
# field when
# targeting_type is
# `TARGETING_TYPE_DEVICE_MAKE_MODEL`.
"negative": True or False, # Indicates if this option is being negatively targeted.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_DEVICE_MAKE_MODEL`.
"displayName": "A String", # Output only. The display name of the device make and model.
},
"digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be # Digital content label details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`.
#
# Digital content labels are targeting exclusions. Advertiser level digital
# content label exclusions, if set, are always applied in serving (even
# though they aren't visible in line item settings). Line item settings can
# exclude content labels in addition to advertiser exclusions, but can't
# override them. A line item won't serve if all the digital content labels
# are excluded.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`.
"excludedTargetingOptionId": "A String", # Required. ID of the digital content label to be EXCLUDED.
"contentRatingTier": "A String", # Output only. The display name of the digital content label rating tier.
},
"browserDetails": { # Details for assigned browser targeting option. This will be populated in # Browser details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_BROWSER`.
# the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_BROWSER`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_BROWSER`.
"displayName": "A String", # Output only. The display name of the browser.
"negative": True or False, # Indicates if this option is being negatively targeted. All assigned browser
# targeting options on the same line item must have the same value for this
# field.
},
"appCategoryDetails": { # Details for assigned app category targeting option. This will be # App category details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_APP_CATEGORY`.
# populated in the
# app_category_details field of
# an AssignedTargetingOption when
# targeting_type
# is `TARGETING_TYPE_APP_CATEGORY`.
"negative": True or False, # Indicates if this option is being negatively targeted.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_APP_CATEGORY`.
"displayName": "A String", # Output only. The display name of the app category.
},
"contentOutstreamPositionDetails": { # Assigned content outstream position targeting option details. This will be # Content outstream position details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION`.
# populated in the
# content_outstream_position_details
# field when
# targeting_type is
# `TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION`.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION`.
"contentOutstreamPosition": "A String", # Output only. The content outstream position.
},
"negativeKeywordListDetails": { # Targeting details for negative keyword list. This will be populated in the # Keyword details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_NEGATIVE_KEYWORD_LIST`.
#
# A maximum of 4 negative keyword lists can be assigned to a line item.
# details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_NEGATIVE_KEYWORD_LIST`.
"negativeKeywordListId": "A String", # Required. ID of the negative keyword list. Should refer to the
# negative_keyword_list_id
# field of a NegativeKeywordList resource.
},
"genderDetails": { # Details for assigned gender targeting option. This will be populated in # Gender details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_GENDER`.
# the details field of an AssignedTargetingOption when
# targeting_type is
# `TARTGETING_TYPE_GENDER`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_GENDER`.
"gender": "A String", # Output only. The gender of the audience.
},
"name": "A String", # Output only. The resource name for this assigned targeting option.
"inventorySourceDetails": { # Targeting details for inventory source. This will be # Inventory source details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_INVENTORY_SOURCE`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_INVENTORY_SOURCE`.
"inventorySourceId": "A String", # Required. ID of the inventory source. Should refer to the
# inventory_source_id field of an
# InventorySource resource.
},
"sensitiveCategoryExclusionDetails": { # Targeting details for sensitive category. This will be populated in the # Sensitive category details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION`.
#
# Sensitive categories are targeting exclusions. Advertiser level sensitive
# category exclusions, if set, are always applied in serving (even though
# they aren't visible in line item settings). Line item settings can
# exclude sensitive categories in addition to advertiser exclusions, but
# can't override them.
# details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION`.
"excludedTargetingOptionId": "A String", # Required. ID of the sensitive category to be EXCLUDED.
"sensitiveCategory": "A String", # Output only. An enum for the DV360 Sensitive category content classifier.
},
"audienceGroupDetails": { # Assigned audience group targeting option details. This will be populated in # Audience targeting details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_AUDIENCE_GROUP`.
# You can only target one audience group option per line item.
# the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_AUDIENCE_GROUP`.
# The relation between each group is UNION, except for
# excluded_first_and_third_party_audience_group and
# excluded_google_audience_group, of which COMPLEMENT is UNION'ed with other
# groups.
"includedFirstAndThirdPartyAudienceGroups": [ # The first and third party audience ids and recencies of included first
# and third party audience groups. Each first and third party audience group
# contains first and third party audience ids only.
# The relation between each first and third party audience group is
# INTERSECTION, and the result is UNION'ed with other audience groups.
# Repeated groups with same settings will be ignored.
{ # Details of first and third party audience group.
# All first and third party audience targeting settings are logically ‘OR’ of
# each other.
"settings": [ # Required. All first and third party audience targeting settings in first and
# third party audience group.
# Repeated settings with same id are not allowed.
{ # Details of first and third party audience targeting setting.
"recency": "A String", # The recency of the first and third party audience targeting setting.
# Only applicable to first party audiences, otherwise
# will be ignored. For more info, refer to
# https://support.google.com/displayvideo/answer/2949947#recency
# When unspecified, no recency limit will be used.
"firstAndThirdPartyAudienceId": "A String", # Required. First and third party audience id of the first and third party audience
# targeting setting. This id is
# first_and_third_party_audience_id.
},
],
},
],
"includedCombinedAudienceGroup": { # Details of combined audience group. # The combined audience ids of the included combined audience group.
# Contains combined audience ids only.
# All combined audience targeting settings are logically ‘OR’ of each other.
"settings": [ # Required. All combined audience targeting settings in combined audience group.
# Repeated settings with same id will be ignored.
# The number of combined audience settings should be no more than five, error
# will be thrown otherwise.
{ # Details of combined audience targeting setting.
"combinedAudienceId": "A String", # Required. Combined audience id of combined audience targeting setting.
# This id is combined_audience_id.
},
],
},
"includedCustomListGroup": { # Details of custom list group. # The custom list ids of the included custom list group.
# Contains custom list ids only.
# All custom list targeting settings are logically ‘OR’ of each other.
"settings": [ # Required. All custom list targeting settings in custom list group.
# Repeated settings with same id will be ignored.
{ # Details of custom list targeting setting.
"customListId": "A String", # Required. Custom id of custom list targeting setting.
# This id is custom_list_id.
},
],
},
"excludedFirstAndThirdPartyAudienceGroup": { # Details of first and third party audience group. # The first and third party audience ids and recencies of the excluded
# first and third party audience group. Used for negative targeting. Its
# COMPLEMENT is used to UNION other audience groups.
# All first and third party audience targeting settings are logically ‘OR’ of
# each other.
"settings": [ # Required. All first and third party audience targeting settings in first and
# third party audience group.
# Repeated settings with same id are not allowed.
{ # Details of first and third party audience targeting setting.
"recency": "A String", # The recency of the first and third party audience targeting setting.
# Only applicable to first party audiences, otherwise
# will be ignored. For more info, refer to
# https://support.google.com/displayvideo/answer/2949947#recency
# When unspecified, no recency limit will be used.
"firstAndThirdPartyAudienceId": "A String", # Required. First and third party audience id of the first and third party audience
# targeting setting. This id is
# first_and_third_party_audience_id.
},
],
},
"includedGoogleAudienceGroup": { # Details of Google audience group. # The Google audience ids of the included Google audience group.
# Contains Google audience ids only.
# All Google audience targeting settings are logically ‘OR’ of each other.
"settings": [ # Required. All Google audience targeting settings in Google audience group.
# Repeated settings with same id will be ignored.
{ # Details of Google audience targeting setting.
"googleAudienceId": "A String", # Required. Google audience id of the Google audience targeting setting.
# This id is google_audience_id.
},
],
},
"excludedGoogleAudienceGroup": { # Details of Google audience group. # The Google audience ids of the excluded Google audience group.
# Used for negative targeting. It's COMPLEMENT is used to UNION other
# audience groups.
# Only contains Affinity, In-market and Installed-apps type Google audiences.
# All items are logically ‘OR’ of each other.
# All Google audience targeting settings are logically ‘OR’ of each other.
"settings": [ # Required. All Google audience targeting settings in Google audience group.
# Repeated settings with same id will be ignored.
{ # Details of Google audience targeting setting.
"googleAudienceId": "A String", # Required. Google audience id of the Google audience targeting setting.
# This id is google_audience_id.
},
],
},
},
"userRewardedContentDetails": { # User rewarded content targeting option details. This will be populated in # User rewarded content details. This field will be populated when the
# TargetingType is
# `TARGETING_TYPE_USER_REWARDED_CONTENT`.
# the
# user_rewarded_content_details
# field when
# targeting_type is
# `TARGETING_TYPE_USER_REWARDED_CONTENT`.
"userRewardedContent": "A String", # Output only. User rewarded content status for video ads.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_USER_REWARDED_CONTENT`.
},
"languageDetails": { # Details for assigned language targeting option. This will be populated in the # Language details. This field will be populated when the TargetingType is
# `TARGETING_TYPE_LANGUAGE`.
# details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_LANGUAGE`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_LANGUAGE`.
"displayName": "A String", # Output only. The display name of the language (e.g., "French").
"negative": True or False, # Indicates if this option is being negatively targeted. All assigned
# language targeting options on the same line item must have the same value
# for this field.
},
"authorizedSellerStatusDetails": { # Represents an assigned authorized seller status. This will be populated in # Authorized seller status details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_AUTHORIZED_SELLER_STATUS`.
#
# You can only target one authorized seller status option per line item.
#
# If a line item doesn't have an authorized seller status option, all
# authorized sellers indicated as DIRECT or RESELLER in the ads.txt file
# are targeted by default.
# the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_AUTHORIZED_SELLER_STATUS`.
"authorizedSellerStatus": "A String", # Output only. The authorized seller status to target.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_AUTHORIZED_SELLER_STATUS`.
},
"dayAndTimeDetails": { # Representation of a segment of time defined on a specific day of the week and # Day and time details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_DAY_AND_TIME`.
# with a start and end time.
# The time represented by `start_hour` must be before the time represented by
# `end_hour`.
"dayOfWeek": "A String", # Required. The day of the week for this day and time targeting setting.
"startHour": 42, # Required. The start hour for day and time targeting. Must be between 0 (start of day)
# and 23 (1 hour before end of day).
"endHour": 42, # Required. The end hour for day and time targeting. Must be between 1 (1 hour after
# start of day) and 24 (end of day).
"timeZoneResolution": "A String", # Required. The mechanism used to determine which timezone to use for this day and time
# targeting setting.
},
"inheritance": "A String", # Output only. The inheritance status of the assigned targeting option.
"environmentDetails": { # Assigned environment targeting option details. This will be populated # Environment details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_ENVIRONMENT`.
# in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_ENVIRONMENT`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_ENVIRONMENT` (e.g., "508010"
# for targeting the `ENVIRONMENT_WEB_OPTIMIZED` option).
"environment": "A String", # Output only. The serving environment.
},
"geoRegionDetails": { # Details for assigned geographic region targeting option. This will be # Geographic region details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_GEO_REGION`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_GEO_REGION`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_GEO_REGION`.
"displayName": "A String", # Output only. The display name of the geographic region (e.g., "Ontario, Canada").
"geoRegionType": "A String", # Output only. The type of geographic region targeting.
"negative": True or False, # Indicates if this option is being negatively targeted.
},
"deviceTypeDetails": { # Targeting details for device type. This will be # Device Type details. This field will be populated when the
# TargetingType is
# `TARGETING_TYPE_DEVICE_TYPE`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_DEVICE_TYPE`.
"targetingOptionId": "A String", # Required. ID of the device type.
"deviceType": "A String", # Output only. The display name of the device type.
},
"exchangeDetails": { # Details for assigned exchange targeting option. This will be populated in # Exchange details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_EXCHANGE`.
# the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_EXCHANGE`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_EXCHANGE`.
},
"assignedTargetingOptionId": "A String", # Output only. The unique ID of the assigned targeting option. The ID is only unique
# within a given line item and targeting type. It may be reused in other
# contexts.
"householdIncomeDetails": { # Details for assigned household income targeting option. This will be # Household income details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_HOUSEHOLD_INCOME`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_HOUSEHOLD_INCOME`.
"householdIncome": "A String", # Output only. The household income of the audience.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_HOUSEHOLD_INCOME`.
},
"contentInstreamPositionDetails": { # Assigned content instream position targeting option details. This will be # Content instream position details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_CONTENT_INSTREAM_POSITION`.
# populated in the
# content_instream_position_details
# field when
# targeting_type is
# `TARGETING_TYPE_CONTENT_INSTREAM_POSITION`.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_CONTENT_INSTREAM_POSITION`.
"contentInstreamPosition": "A String", # Output only. The content instream position for video or audio ads.
},
"categoryDetails": { # Assigned category targeting option details. This will be populated in the # Category details. This field will be populated when the TargetingType is
# `TARGETING_TYPE_CATEGORY`.
#
# Targeting a category will also target its subcategories. If a category is
# excluded from targeting and a subcategory is included, the exclusion will
# take precedence.
# category_details field when
# targeting_type is
# `TARGETING_TYPE_CATEGORY`.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_CATEGORY`.
"displayName": "A String", # Output only. The display name of the category.
"negative": True or False, # Indicates if this option is being negatively targeted.
},
"inventorySourceGroupDetails": { # Targeting details for inventory source group. This will be # Inventory source group details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_INVENTORY_SOURCE_GROUP`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_INVENTORY_SOURCE_GROUP`.
"inventorySourceGroupId": "A String", # Required. ID of the inventory source group. Should refer to the
# inventory_source_group_id
# field of an InventorySourceGroup resource.
},
"regionalLocationListDetails": { # Targeting details for regional location list. This will be # Regional location list details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_REGIONAL_LOCATION_LIST`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_REGIONAL_LOCATION_LIST`.
"regionalLocationListId": "A String", # Required. ID of the regional location list. Should refer to the
# location_list_id field of a
# LocationList resource whose type is `TARGETING_LOCATION_TYPE_REGIONAL`.
"negative": True or False, # Indicates if this option is being negatively targeted.
},
"carrierAndIspDetails": { # Details for assigned carrier and ISP targeting option. This will be populated # Carrier and ISP details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_CARRIER_AND_ISP`.
# in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_CARRIER_AND_ISP`.
"negative": True or False, # Indicates if this option is being negatively targeted. All assigned carrier
# and ISP targeting options on the same line item must have the same value
# for this field.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_CARRIER_AND_ISP`.
"displayName": "A String", # Output only. The display name of the carrier or ISP.
},
"viewabilityDetails": { # Assigned viewability targeting option details. This will be populated in the # Viewability details. This field will be populated when the TargetingType
# is `TARGETING_TYPE_VIEWABILITY`.
#
# You can only target one viewability option per line item.
# viewability_details field of
# an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_VIEWABILITY`.
"viewability": "A String", # Output only. The predicted viewability percentage.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_VIEWABILITY` (e.g., "509010"
# for targeting the `VIEWABILITY_10_PERCENT_OR_MORE` option).
},
}
delete(advertiserId, lineItemId, targetingType, assignedTargetingOptionId, x__xgafv=None)
Deletes an assigned targeting option from a line item.
Args:
advertiserId: string, Required. The ID of the advertiser the line item belongs to. (required)
lineItemId: string, Required. The ID of the line item the assigned targeting option belongs to. (required)
targetingType: string, Required. Identifies the type of this assigned targeting option. (required)
assignedTargetingOptionId: string, Required. The ID of the assigned targeting option to delete. (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # A generic empty message that you can re-use to avoid defining duplicated
# empty messages in your APIs. A typical example is to use it as the request
# or the response type of an API method. For instance:
#
# service Foo {
# rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
# }
#
# The JSON representation for `Empty` is empty JSON object `{}`.
}
get(advertiserId, lineItemId, targetingType, assignedTargetingOptionId, x__xgafv=None)
Gets a single targeting option assigned to a line item.
Args:
advertiserId: string, Required. The ID of the advertiser the line item belongs to. (required)
lineItemId: string, Required. The ID of the line item the assigned targeting option belongs to. (required)
targetingType: string, Required. Identifies the type of this assigned targeting option. (required)
assignedTargetingOptionId: string, Required. An identifier unique to the targeting type in this line item that
identifies the assigned targeting option being requested. (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # A single assigned targeting option, which defines the state of a targeting
# option for an entity with targeting settings, such as a Line Item or
# Insertion Order.
"appDetails": { # Details for assigned app targeting option. This will be populated in the # App details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_APP`.
# details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_APP`.
"displayName": "A String", # Output only. The display name of the app.
"appId": "A String", # Required. The ID of the app.
#
# Android's Play store app uses bundle ID, for example
# `com.google.android.gm`. Apple's App store app ID uses 9 digit string, for
# example `422689480`.
"negative": True or False, # Indicates if this option is being negatively targeted.
},
"parentalStatusDetails": { # Details for assigned parental status targeting option. This will be # Parental status details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_PARENTAL_STATUS`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARTGETING_TYPE_PARENTAL_STATUS`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_PARENTAL_STATUS`.
"parentalStatus": "A String", # Output only. The parental status of the audience.
},
"targetingType": "A String", # Output only. Identifies the type of this assigned targeting option.
"urlDetails": { # Details for assigned URL targeting option. This will be populated in the # URL details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_URL`.
# details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_URL`.
"url": "A String", # Required. The URL, for example `example.com`.
#
# DV360 supports two levels of subdirectory targeting, for example
# `www.example.com/one-subdirectory-level/second-level`, and five levels of
# subdomain targeting, for example `five.four.three.two.one.example.com`.
"negative": True or False, # Indicates if this option is being negatively targeted.
},
"onScreenPositionDetails": { # On screen position targeting option details. This will be # On screen position details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_ON_SCREEN_POSITION`.
# populated in the
# on_screen_position_details
# field when
# targeting_type is
# `TARGETING_TYPE_ON_SCREEN_POSITION`.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_ON_SCREEN_POSITION`.
"onScreenPosition": "A String", # Output only. The on screen position.
},
"videoPlayerSizeDetails": { # Video player size targeting option details. This will be populated in the # Video player size details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_VIDEO_PLAYER_SIZE`.
# video_player_size_details
# field when targeting_type is
# `TARGETING_TYPE_VIDEO_PLAYER_SIZE`.
# Explicitly targeting all options is not supported. Remove all video player
# size targeting options to achieve this effect.
"videoPlayerSize": "A String", # Output only. The video player size.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_VIDEO_PLAYER_SIZE`.
},
"channelDetails": { # Details for assigned channel targeting option. This will be populated in # Channel details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_CHANNEL`.
# the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_CHANNEL`.
"channelId": "A String", # Required. ID of the channel. Should refer to the channel ID
# field on a
# [Partner-owned channel](partners.channels#Channel.FIELDS.channel_id) or
# [advertiser-owned channel](advertisers.channels#Channel.FIELDS.channel_id)
# resource.
"negative": True or False, # Indicates if this option is being negatively targeted. For advertiser
# level assigned targeting option, this field must be true.
},
"operatingSystemDetails": { # Assigned operating system targeting option details. This will be # Operating system details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_OPERATING_SYSTEM`.
# populated in the
# operating_system_details
# field when
# targeting_type is
# `TARGETING_TYPE_OPERATING_SYSTEM`.
"displayName": "A String", # Output only. The display name of the operating system.
"negative": True or False, # Indicates if this option is being negatively targeted.
"targetingOptionId": "A String", # Required. The targeting option ID populated in
# targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_OPERATING_SYSTEM`.
},
"thirdPartyVerifierDetails": { # Assigned third party verifier targeting option details. This will be # Third party verification details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_THIRD_PARTY_VERIFIER`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_THIRD_PARTY_VERIFIER`.
"integralAdScience": { # Details of Integral Ad Science settings. # Third party brand verifier -- Integral Ad Science.
"excludedAdFraudRisk": "A String", # Ad Fraud settings.
"displayViewability": "A String", # Display Viewability section (applicable to display line items only).
"excludedHateSpeechRisk": "A String", # Brand Safety - **Hate speech**.
"excludedOffensiveLanguageRisk": "A String", # Brand Safety - **Offensive language**.
"excludedDrugsRisk": "A String", # Brand Safety - **Drugs**.
"excludedAdultRisk": "A String", # Brand Safety - **Adult content**.
"traqScoreOption": "A String", # True advertising quality (applicable to Display line items only).
"videoViewability": "A String", # Video Viewability Section (applicable to video line items only).
"excludedAlcoholRisk": "A String", # Brand Safety - **Alcohol**.
"excludedGamblingRisk": "A String", # Brand Safety - **Gambling**.
"excludeUnrateable": True or False, # Brand Safety - **Unrateable**.
"excludedIllegalDownloadsRisk": "A String", # Brand Safety - **Illegal downloads**.
"excludedViolenceRisk": "A String", # Brand Safety - **Violence**.
},
"doubleVerify": { # Details of DoubleVerify settings. # Third party brand verifier -- DoubleVerify.
"videoViewability": { # Details of DoubleVerify video viewability settings. # Video viewability settings (applicable to video line items only).
"playerImpressionRate": "A String", # Target inventory to maximize impressions with 400x300 or greater player
# size.
"videoIab": "A String", # Target web inventory to maximize IAB viewable rate.
"videoViewableRate": "A String", # Target web inventory to maximize fully viewable rate.
},
"avoidedAgeRatings": [ # Avoid bidding on apps with the age rating.
"A String",
],
"fraudInvalidTraffic": { # DoubleVerify Fraud & Invalid Traffic settings. # Avoid Sites and Apps with historical Fraud & IVT Rates.
"avoidInsufficientOption": True or False, # Insufficient Historical Fraud & IVT Stats.
"avoidedFraudOption": "A String", # Avoid Sites and Apps with historical Fraud & IVT.
},
"brandSafetyCategories": { # Settings for brand safety controls. # DV Brand Safety Controls.
"avoidedMediumSeverityCategories": [ # Brand safety medium severity avoidance categories.
"A String",
],
"avoidedHighSeverityCategories": [ # Brand safety high severity avoidance categories.
"A String",
],
"avoidUnknownBrandSafetyCategory": True or False, # Unknown or unrateable.
},
"appStarRating": { # Details of DoubleVerify star ratings settings. # Avoid bidding on apps with the star ratings.
"avoidedStarRating": "A String", # Avoid bidding on apps with the star ratings.
"avoidInsufficientStarRating": True or False, # Avoid bidding on apps with insufficient star ratings.
},
"displayViewability": { # Details of DoubleVerify display viewability settings. # Display viewability settings (applicable to display line items only).
"viewableDuring": "A String", # Target web and app inventory to maximize 100% viewable duration.
"iab": "A String", # Target web and app inventory to maximize IAB viewable rate.
},
},
"adloox": { # Details of Adloox settings. # Third party brand verifier -- Adloox.
"excludedAdlooxCategories": [ # Adloox's brand safety settings.
"A String",
],
},
},
"proximityLocationListDetails": { # Targeting details for proximity location list. This will be # Proximity location list details. This field will be populated when the
# TargetingType is
# `TARGETING_TYPE_PROXIMITY_LOCATION_LIST`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_PROXIMITY_LOCATION_LIST`.
"proximityRadiusRange": "A String", # Required. Radius range for proximity location list.
# This represents the size of the area around a chosen location that will be
# targeted.
#
# `All` proximity location targeting under a single line item must have the
# same radius range value. Set this value to match any existing targeting.
# If updated, this field will change the radius range for all proximity
# targeting under the line item.
"proximityLocationListId": "A String", # Required. ID of the proximity location list. Should refer to the
# location_list_id field of a
# LocationList resource whose type is
# `TARGETING_LOCATION_TYPE_PROXIMITY`.
},
"ageRangeDetails": { # Represents a targetable age range. This will be populated in the details # Age range details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_AGE_RANGE`.
# field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_AGE_RANGE`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_AGE_RANGE`.
"ageRange": "A String", # Output only. The age range of an audience. We only support targeting a continuous age
# range of an audience. Thus, the age range represented in this field can be
# 1) targeted solely, or, 2) part of a larger continuous age range. The reach
# of a continuous age range targeting can be expanded by also targeting an
# audience of an unknown age.
},
"subExchangeDetails": { # Details for assigned sub-exchange targeting option. This will be populated in # Sub-exchange details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_SUB_EXCHANGE`.
# the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_SUB_EXCHANGE`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_SUB_EXCHANGE`.
},
"keywordDetails": { # Details for assigned keyword targeting option. This will be populated in the # Keyword details. This field will be populated when the TargetingType is
# `TARGETING_TYPE_KEYWORD`.
#
# A maximum of 5000 direct negative keywords can be assigned to a
# line item. No limit on number of positive keywords that can be assigned.
# details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_KEYWORD`.
"negative": True or False, # Indicates if this option is being negatively targeted.
"keyword": "A String", # Required. The keyword, for example `car insurance`.
#
# Positive keyword cannot be offensive word.
# Must be UTF-8 encoded with a maximum size of 255 bytes. Maximum number
# of characters is 80. Maximum number of words is 10.
},
"deviceMakeModelDetails": { # Assigned device make and model targeting option details. This will be # Device make and model details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_DEVICE_MAKE_MODEL`.
# populated in the
# device_make_model_details
# field when
# targeting_type is
# `TARGETING_TYPE_DEVICE_MAKE_MODEL`.
"negative": True or False, # Indicates if this option is being negatively targeted.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_DEVICE_MAKE_MODEL`.
"displayName": "A String", # Output only. The display name of the device make and model.
},
"digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be # Digital content label details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`.
#
# Digital content labels are targeting exclusions. Advertiser level digital
# content label exclusions, if set, are always applied in serving (even
# though they aren't visible in line item settings). Line item settings can
# exclude content labels in addition to advertiser exclusions, but can't
# override them. A line item won't serve if all the digital content labels
# are excluded.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`.
"excludedTargetingOptionId": "A String", # Required. ID of the digital content label to be EXCLUDED.
"contentRatingTier": "A String", # Output only. The display name of the digital content label rating tier.
},
"browserDetails": { # Details for assigned browser targeting option. This will be populated in # Browser details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_BROWSER`.
# the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_BROWSER`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_BROWSER`.
"displayName": "A String", # Output only. The display name of the browser.
"negative": True or False, # Indicates if this option is being negatively targeted. All assigned browser
# targeting options on the same line item must have the same value for this
# field.
},
"appCategoryDetails": { # Details for assigned app category targeting option. This will be # App category details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_APP_CATEGORY`.
# populated in the
# app_category_details field of
# an AssignedTargetingOption when
# targeting_type
# is `TARGETING_TYPE_APP_CATEGORY`.
"negative": True or False, # Indicates if this option is being negatively targeted.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_APP_CATEGORY`.
"displayName": "A String", # Output only. The display name of the app category.
},
"contentOutstreamPositionDetails": { # Assigned content outstream position targeting option details. This will be # Content outstream position details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION`.
# populated in the
# content_outstream_position_details
# field when
# targeting_type is
# `TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION`.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION`.
"contentOutstreamPosition": "A String", # Output only. The content outstream position.
},
"negativeKeywordListDetails": { # Targeting details for negative keyword list. This will be populated in the # Keyword details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_NEGATIVE_KEYWORD_LIST`.
#
# A maximum of 4 negative keyword lists can be assigned to a line item.
# details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_NEGATIVE_KEYWORD_LIST`.
"negativeKeywordListId": "A String", # Required. ID of the negative keyword list. Should refer to the
# negative_keyword_list_id
# field of a NegativeKeywordList resource.
},
"genderDetails": { # Details for assigned gender targeting option. This will be populated in # Gender details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_GENDER`.
# the details field of an AssignedTargetingOption when
# targeting_type is
# `TARTGETING_TYPE_GENDER`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_GENDER`.
"gender": "A String", # Output only. The gender of the audience.
},
"name": "A String", # Output only. The resource name for this assigned targeting option.
"inventorySourceDetails": { # Targeting details for inventory source. This will be # Inventory source details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_INVENTORY_SOURCE`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_INVENTORY_SOURCE`.
"inventorySourceId": "A String", # Required. ID of the inventory source. Should refer to the
# inventory_source_id field of an
# InventorySource resource.
},
"sensitiveCategoryExclusionDetails": { # Targeting details for sensitive category. This will be populated in the # Sensitive category details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION`.
#
# Sensitive categories are targeting exclusions. Advertiser level sensitive
# category exclusions, if set, are always applied in serving (even though
# they aren't visible in line item settings). Line item settings can
# exclude sensitive categories in addition to advertiser exclusions, but
# can't override them.
# details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION`.
"excludedTargetingOptionId": "A String", # Required. ID of the sensitive category to be EXCLUDED.
"sensitiveCategory": "A String", # Output only. An enum for the DV360 Sensitive category content classifier.
},
"audienceGroupDetails": { # Assigned audience group targeting option details. This will be populated in # Audience targeting details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_AUDIENCE_GROUP`.
# You can only target one audience group option per line item.
# the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_AUDIENCE_GROUP`.
# The relation between each group is UNION, except for
# excluded_first_and_third_party_audience_group and
# excluded_google_audience_group, of which COMPLEMENT is UNION'ed with other
# groups.
"includedFirstAndThirdPartyAudienceGroups": [ # The first and third party audience ids and recencies of included first
# and third party audience groups. Each first and third party audience group
# contains first and third party audience ids only.
# The relation between each first and third party audience group is
# INTERSECTION, and the result is UNION'ed with other audience groups.
# Repeated groups with same settings will be ignored.
{ # Details of first and third party audience group.
# All first and third party audience targeting settings are logically ‘OR’ of
# each other.
"settings": [ # Required. All first and third party audience targeting settings in first and
# third party audience group.
# Repeated settings with same id are not allowed.
{ # Details of first and third party audience targeting setting.
"recency": "A String", # The recency of the first and third party audience targeting setting.
# Only applicable to first party audiences, otherwise
# will be ignored. For more info, refer to
# https://support.google.com/displayvideo/answer/2949947#recency
# When unspecified, no recency limit will be used.
"firstAndThirdPartyAudienceId": "A String", # Required. First and third party audience id of the first and third party audience
# targeting setting. This id is
# first_and_third_party_audience_id.
},
],
},
],
"includedCombinedAudienceGroup": { # Details of combined audience group. # The combined audience ids of the included combined audience group.
# Contains combined audience ids only.
# All combined audience targeting settings are logically ‘OR’ of each other.
"settings": [ # Required. All combined audience targeting settings in combined audience group.
# Repeated settings with same id will be ignored.
# The number of combined audience settings should be no more than five, error
# will be thrown otherwise.
{ # Details of combined audience targeting setting.
"combinedAudienceId": "A String", # Required. Combined audience id of combined audience targeting setting.
# This id is combined_audience_id.
},
],
},
"includedCustomListGroup": { # Details of custom list group. # The custom list ids of the included custom list group.
# Contains custom list ids only.
# All custom list targeting settings are logically ‘OR’ of each other.
"settings": [ # Required. All custom list targeting settings in custom list group.
# Repeated settings with same id will be ignored.
{ # Details of custom list targeting setting.
"customListId": "A String", # Required. Custom id of custom list targeting setting.
# This id is custom_list_id.
},
],
},
"excludedFirstAndThirdPartyAudienceGroup": { # Details of first and third party audience group. # The first and third party audience ids and recencies of the excluded
# first and third party audience group. Used for negative targeting. Its
# COMPLEMENT is used to UNION other audience groups.
# All first and third party audience targeting settings are logically ‘OR’ of
# each other.
"settings": [ # Required. All first and third party audience targeting settings in first and
# third party audience group.
# Repeated settings with same id are not allowed.
{ # Details of first and third party audience targeting setting.
"recency": "A String", # The recency of the first and third party audience targeting setting.
# Only applicable to first party audiences, otherwise
# will be ignored. For more info, refer to
# https://support.google.com/displayvideo/answer/2949947#recency
# When unspecified, no recency limit will be used.
"firstAndThirdPartyAudienceId": "A String", # Required. First and third party audience id of the first and third party audience
# targeting setting. This id is
# first_and_third_party_audience_id.
},
],
},
"includedGoogleAudienceGroup": { # Details of Google audience group. # The Google audience ids of the included Google audience group.
# Contains Google audience ids only.
# All Google audience targeting settings are logically ‘OR’ of each other.
"settings": [ # Required. All Google audience targeting settings in Google audience group.
# Repeated settings with same id will be ignored.
{ # Details of Google audience targeting setting.
"googleAudienceId": "A String", # Required. Google audience id of the Google audience targeting setting.
# This id is google_audience_id.
},
],
},
"excludedGoogleAudienceGroup": { # Details of Google audience group. # The Google audience ids of the excluded Google audience group.
# Used for negative targeting. It's COMPLEMENT is used to UNION other
# audience groups.
# Only contains Affinity, In-market and Installed-apps type Google audiences.
# All items are logically ‘OR’ of each other.
# All Google audience targeting settings are logically ‘OR’ of each other.
"settings": [ # Required. All Google audience targeting settings in Google audience group.
# Repeated settings with same id will be ignored.
{ # Details of Google audience targeting setting.
"googleAudienceId": "A String", # Required. Google audience id of the Google audience targeting setting.
# This id is google_audience_id.
},
],
},
},
"userRewardedContentDetails": { # User rewarded content targeting option details. This will be populated in # User rewarded content details. This field will be populated when the
# TargetingType is
# `TARGETING_TYPE_USER_REWARDED_CONTENT`.
# the
# user_rewarded_content_details
# field when
# targeting_type is
# `TARGETING_TYPE_USER_REWARDED_CONTENT`.
"userRewardedContent": "A String", # Output only. User rewarded content status for video ads.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_USER_REWARDED_CONTENT`.
},
"languageDetails": { # Details for assigned language targeting option. This will be populated in the # Language details. This field will be populated when the TargetingType is
# `TARGETING_TYPE_LANGUAGE`.
# details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_LANGUAGE`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_LANGUAGE`.
"displayName": "A String", # Output only. The display name of the language (e.g., "French").
"negative": True or False, # Indicates if this option is being negatively targeted. All assigned
# language targeting options on the same line item must have the same value
# for this field.
},
"authorizedSellerStatusDetails": { # Represents an assigned authorized seller status. This will be populated in # Authorized seller status details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_AUTHORIZED_SELLER_STATUS`.
#
# You can only target one authorized seller status option per line item.
#
# If a line item doesn't have an authorized seller status option, all
# authorized sellers indicated as DIRECT or RESELLER in the ads.txt file
# are targeted by default.
# the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_AUTHORIZED_SELLER_STATUS`.
"authorizedSellerStatus": "A String", # Output only. The authorized seller status to target.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_AUTHORIZED_SELLER_STATUS`.
},
"dayAndTimeDetails": { # Representation of a segment of time defined on a specific day of the week and # Day and time details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_DAY_AND_TIME`.
# with a start and end time.
# The time represented by `start_hour` must be before the time represented by
# `end_hour`.
"dayOfWeek": "A String", # Required. The day of the week for this day and time targeting setting.
"startHour": 42, # Required. The start hour for day and time targeting. Must be between 0 (start of day)
# and 23 (1 hour before end of day).
"endHour": 42, # Required. The end hour for day and time targeting. Must be between 1 (1 hour after
# start of day) and 24 (end of day).
"timeZoneResolution": "A String", # Required. The mechanism used to determine which timezone to use for this day and time
# targeting setting.
},
"inheritance": "A String", # Output only. The inheritance status of the assigned targeting option.
"environmentDetails": { # Assigned environment targeting option details. This will be populated # Environment details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_ENVIRONMENT`.
# in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_ENVIRONMENT`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_ENVIRONMENT` (e.g., "508010"
# for targeting the `ENVIRONMENT_WEB_OPTIMIZED` option).
"environment": "A String", # Output only. The serving environment.
},
"geoRegionDetails": { # Details for assigned geographic region targeting option. This will be # Geographic region details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_GEO_REGION`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_GEO_REGION`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_GEO_REGION`.
"displayName": "A String", # Output only. The display name of the geographic region (e.g., "Ontario, Canada").
"geoRegionType": "A String", # Output only. The type of geographic region targeting.
"negative": True or False, # Indicates if this option is being negatively targeted.
},
"deviceTypeDetails": { # Targeting details for device type. This will be # Device Type details. This field will be populated when the
# TargetingType is
# `TARGETING_TYPE_DEVICE_TYPE`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_DEVICE_TYPE`.
"targetingOptionId": "A String", # Required. ID of the device type.
"deviceType": "A String", # Output only. The display name of the device type.
},
"exchangeDetails": { # Details for assigned exchange targeting option. This will be populated in # Exchange details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_EXCHANGE`.
# the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_EXCHANGE`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_EXCHANGE`.
},
"assignedTargetingOptionId": "A String", # Output only. The unique ID of the assigned targeting option. The ID is only unique
# within a given line item and targeting type. It may be reused in other
# contexts.
"householdIncomeDetails": { # Details for assigned household income targeting option. This will be # Household income details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_HOUSEHOLD_INCOME`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_HOUSEHOLD_INCOME`.
"householdIncome": "A String", # Output only. The household income of the audience.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_HOUSEHOLD_INCOME`.
},
"contentInstreamPositionDetails": { # Assigned content instream position targeting option details. This will be # Content instream position details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_CONTENT_INSTREAM_POSITION`.
# populated in the
# content_instream_position_details
# field when
# targeting_type is
# `TARGETING_TYPE_CONTENT_INSTREAM_POSITION`.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_CONTENT_INSTREAM_POSITION`.
"contentInstreamPosition": "A String", # Output only. The content instream position for video or audio ads.
},
"categoryDetails": { # Assigned category targeting option details. This will be populated in the # Category details. This field will be populated when the TargetingType is
# `TARGETING_TYPE_CATEGORY`.
#
# Targeting a category will also target its subcategories. If a category is
# excluded from targeting and a subcategory is included, the exclusion will
# take precedence.
# category_details field when
# targeting_type is
# `TARGETING_TYPE_CATEGORY`.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_CATEGORY`.
"displayName": "A String", # Output only. The display name of the category.
"negative": True or False, # Indicates if this option is being negatively targeted.
},
"inventorySourceGroupDetails": { # Targeting details for inventory source group. This will be # Inventory source group details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_INVENTORY_SOURCE_GROUP`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_INVENTORY_SOURCE_GROUP`.
"inventorySourceGroupId": "A String", # Required. ID of the inventory source group. Should refer to the
# inventory_source_group_id
# field of an InventorySourceGroup resource.
},
"regionalLocationListDetails": { # Targeting details for regional location list. This will be # Regional location list details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_REGIONAL_LOCATION_LIST`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_REGIONAL_LOCATION_LIST`.
"regionalLocationListId": "A String", # Required. ID of the regional location list. Should refer to the
# location_list_id field of a
# LocationList resource whose type is `TARGETING_LOCATION_TYPE_REGIONAL`.
"negative": True or False, # Indicates if this option is being negatively targeted.
},
"carrierAndIspDetails": { # Details for assigned carrier and ISP targeting option. This will be populated # Carrier and ISP details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_CARRIER_AND_ISP`.
# in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_CARRIER_AND_ISP`.
"negative": True or False, # Indicates if this option is being negatively targeted. All assigned carrier
# and ISP targeting options on the same line item must have the same value
# for this field.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_CARRIER_AND_ISP`.
"displayName": "A String", # Output only. The display name of the carrier or ISP.
},
"viewabilityDetails": { # Assigned viewability targeting option details. This will be populated in the # Viewability details. This field will be populated when the TargetingType
# is `TARGETING_TYPE_VIEWABILITY`.
#
# You can only target one viewability option per line item.
# viewability_details field of
# an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_VIEWABILITY`.
"viewability": "A String", # Output only. The predicted viewability percentage.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_VIEWABILITY` (e.g., "509010"
# for targeting the `VIEWABILITY_10_PERCENT_OR_MORE` option).
},
}
list(advertiserId, lineItemId, targetingType, orderBy=None, filter=None, pageToken=None, pageSize=None, x__xgafv=None)
Lists the targeting options assigned to a line item.
Args:
advertiserId: string, Required. The ID of the advertiser the line item belongs to. (required)
lineItemId: string, Required. The ID of the line item to list assigned targeting options for. (required)
targetingType: string, Required. Identifies the type of assigned targeting options to list. (required)
orderBy: string, Field by which to sort the list.
Acceptable values are:
* `assignedTargetingOptionId` (default)
The default sorting order is ascending. To specify descending order for
a field, a suffix "desc" should be added to the field name. Example:
`assignedTargetingOptionId desc`.
filter: string, Allows filtering by assigned targeting option properties.
Supported syntax:
* Filter expressions are made up of one or more restrictions.
* Restrictions can be combined by the logical operator `OR`.
* A restriction has the form of `{field} {operator} {value}`.
* The operator must be `EQUALS (=)`.
* Supported fields:
- `assignedTargetingOptionId`
- `inheritance`
Examples:
* AssignedTargetingOptions with ID 1 or 2
`assignedTargetingOptionId="1" OR assignedTargetingOptionId="2"`
* AssignedTargetingOptions with inheritance status of NOT_INHERITED or
INHERITED_FROM_PARTNER
`inheritance="NOT_INHERITED" OR inheritance="INHERITED_FROM_PARTNER"`
The length of this field should be no more than 500 characters.
pageToken: string, A token identifying a page of results the server should return.
Typically, this is the value of
next_page_token
returned from the previous call to `ListLineItemAssignedTargetingOptions`
method. If not specified, the first page of results will be returned.
pageSize: integer, Requested page size. Must be between `1` and `100`. If unspecified will
default to `100`. Returns error code `INVALID_ARGUMENT` if an invalid value
is specified.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Response message for
# ListLineItemAssignedTargetingOptions.
"assignedTargetingOptions": [ # The list of assigned targeting options.
#
# This list will be absent if empty.
{ # A single assigned targeting option, which defines the state of a targeting
# option for an entity with targeting settings, such as a Line Item or
# Insertion Order.
"appDetails": { # Details for assigned app targeting option. This will be populated in the # App details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_APP`.
# details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_APP`.
"displayName": "A String", # Output only. The display name of the app.
"appId": "A String", # Required. The ID of the app.
#
# Android's Play store app uses bundle ID, for example
# `com.google.android.gm`. Apple's App store app ID uses 9 digit string, for
# example `422689480`.
"negative": True or False, # Indicates if this option is being negatively targeted.
},
"parentalStatusDetails": { # Details for assigned parental status targeting option. This will be # Parental status details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_PARENTAL_STATUS`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARTGETING_TYPE_PARENTAL_STATUS`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_PARENTAL_STATUS`.
"parentalStatus": "A String", # Output only. The parental status of the audience.
},
"targetingType": "A String", # Output only. Identifies the type of this assigned targeting option.
"urlDetails": { # Details for assigned URL targeting option. This will be populated in the # URL details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_URL`.
# details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_URL`.
"url": "A String", # Required. The URL, for example `example.com`.
#
# DV360 supports two levels of subdirectory targeting, for example
# `www.example.com/one-subdirectory-level/second-level`, and five levels of
# subdomain targeting, for example `five.four.three.two.one.example.com`.
"negative": True or False, # Indicates if this option is being negatively targeted.
},
"onScreenPositionDetails": { # On screen position targeting option details. This will be # On screen position details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_ON_SCREEN_POSITION`.
# populated in the
# on_screen_position_details
# field when
# targeting_type is
# `TARGETING_TYPE_ON_SCREEN_POSITION`.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_ON_SCREEN_POSITION`.
"onScreenPosition": "A String", # Output only. The on screen position.
},
"videoPlayerSizeDetails": { # Video player size targeting option details. This will be populated in the # Video player size details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_VIDEO_PLAYER_SIZE`.
# video_player_size_details
# field when targeting_type is
# `TARGETING_TYPE_VIDEO_PLAYER_SIZE`.
# Explicitly targeting all options is not supported. Remove all video player
# size targeting options to achieve this effect.
"videoPlayerSize": "A String", # Output only. The video player size.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_VIDEO_PLAYER_SIZE`.
},
"channelDetails": { # Details for assigned channel targeting option. This will be populated in # Channel details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_CHANNEL`.
# the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_CHANNEL`.
"channelId": "A String", # Required. ID of the channel. Should refer to the channel ID
# field on a
# [Partner-owned channel](partners.channels#Channel.FIELDS.channel_id) or
# [advertiser-owned channel](advertisers.channels#Channel.FIELDS.channel_id)
# resource.
"negative": True or False, # Indicates if this option is being negatively targeted. For advertiser
# level assigned targeting option, this field must be true.
},
"operatingSystemDetails": { # Assigned operating system targeting option details. This will be # Operating system details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_OPERATING_SYSTEM`.
# populated in the
# operating_system_details
# field when
# targeting_type is
# `TARGETING_TYPE_OPERATING_SYSTEM`.
"displayName": "A String", # Output only. The display name of the operating system.
"negative": True or False, # Indicates if this option is being negatively targeted.
"targetingOptionId": "A String", # Required. The targeting option ID populated in
# targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_OPERATING_SYSTEM`.
},
"thirdPartyVerifierDetails": { # Assigned third party verifier targeting option details. This will be # Third party verification details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_THIRD_PARTY_VERIFIER`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_THIRD_PARTY_VERIFIER`.
"integralAdScience": { # Details of Integral Ad Science settings. # Third party brand verifier -- Integral Ad Science.
"excludedAdFraudRisk": "A String", # Ad Fraud settings.
"displayViewability": "A String", # Display Viewability section (applicable to display line items only).
"excludedHateSpeechRisk": "A String", # Brand Safety - **Hate speech**.
"excludedOffensiveLanguageRisk": "A String", # Brand Safety - **Offensive language**.
"excludedDrugsRisk": "A String", # Brand Safety - **Drugs**.
"excludedAdultRisk": "A String", # Brand Safety - **Adult content**.
"traqScoreOption": "A String", # True advertising quality (applicable to Display line items only).
"videoViewability": "A String", # Video Viewability Section (applicable to video line items only).
"excludedAlcoholRisk": "A String", # Brand Safety - **Alcohol**.
"excludedGamblingRisk": "A String", # Brand Safety - **Gambling**.
"excludeUnrateable": True or False, # Brand Safety - **Unrateable**.
"excludedIllegalDownloadsRisk": "A String", # Brand Safety - **Illegal downloads**.
"excludedViolenceRisk": "A String", # Brand Safety - **Violence**.
},
"doubleVerify": { # Details of DoubleVerify settings. # Third party brand verifier -- DoubleVerify.
"videoViewability": { # Details of DoubleVerify video viewability settings. # Video viewability settings (applicable to video line items only).
"playerImpressionRate": "A String", # Target inventory to maximize impressions with 400x300 or greater player
# size.
"videoIab": "A String", # Target web inventory to maximize IAB viewable rate.
"videoViewableRate": "A String", # Target web inventory to maximize fully viewable rate.
},
"avoidedAgeRatings": [ # Avoid bidding on apps with the age rating.
"A String",
],
"fraudInvalidTraffic": { # DoubleVerify Fraud & Invalid Traffic settings. # Avoid Sites and Apps with historical Fraud & IVT Rates.
"avoidInsufficientOption": True or False, # Insufficient Historical Fraud & IVT Stats.
"avoidedFraudOption": "A String", # Avoid Sites and Apps with historical Fraud & IVT.
},
"brandSafetyCategories": { # Settings for brand safety controls. # DV Brand Safety Controls.
"avoidedMediumSeverityCategories": [ # Brand safety medium severity avoidance categories.
"A String",
],
"avoidedHighSeverityCategories": [ # Brand safety high severity avoidance categories.
"A String",
],
"avoidUnknownBrandSafetyCategory": True or False, # Unknown or unrateable.
},
"appStarRating": { # Details of DoubleVerify star ratings settings. # Avoid bidding on apps with the star ratings.
"avoidedStarRating": "A String", # Avoid bidding on apps with the star ratings.
"avoidInsufficientStarRating": True or False, # Avoid bidding on apps with insufficient star ratings.
},
"displayViewability": { # Details of DoubleVerify display viewability settings. # Display viewability settings (applicable to display line items only).
"viewableDuring": "A String", # Target web and app inventory to maximize 100% viewable duration.
"iab": "A String", # Target web and app inventory to maximize IAB viewable rate.
},
},
"adloox": { # Details of Adloox settings. # Third party brand verifier -- Adloox.
"excludedAdlooxCategories": [ # Adloox's brand safety settings.
"A String",
],
},
},
"proximityLocationListDetails": { # Targeting details for proximity location list. This will be # Proximity location list details. This field will be populated when the
# TargetingType is
# `TARGETING_TYPE_PROXIMITY_LOCATION_LIST`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_PROXIMITY_LOCATION_LIST`.
"proximityRadiusRange": "A String", # Required. Radius range for proximity location list.
# This represents the size of the area around a chosen location that will be
# targeted.
#
# `All` proximity location targeting under a single line item must have the
# same radius range value. Set this value to match any existing targeting.
# If updated, this field will change the radius range for all proximity
# targeting under the line item.
"proximityLocationListId": "A String", # Required. ID of the proximity location list. Should refer to the
# location_list_id field of a
# LocationList resource whose type is
# `TARGETING_LOCATION_TYPE_PROXIMITY`.
},
"ageRangeDetails": { # Represents a targetable age range. This will be populated in the details # Age range details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_AGE_RANGE`.
# field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_AGE_RANGE`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_AGE_RANGE`.
"ageRange": "A String", # Output only. The age range of an audience. We only support targeting a continuous age
# range of an audience. Thus, the age range represented in this field can be
# 1) targeted solely, or, 2) part of a larger continuous age range. The reach
# of a continuous age range targeting can be expanded by also targeting an
# audience of an unknown age.
},
"subExchangeDetails": { # Details for assigned sub-exchange targeting option. This will be populated in # Sub-exchange details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_SUB_EXCHANGE`.
# the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_SUB_EXCHANGE`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_SUB_EXCHANGE`.
},
"keywordDetails": { # Details for assigned keyword targeting option. This will be populated in the # Keyword details. This field will be populated when the TargetingType is
# `TARGETING_TYPE_KEYWORD`.
#
# A maximum of 5000 direct negative keywords can be assigned to a
# line item. No limit on number of positive keywords that can be assigned.
# details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_KEYWORD`.
"negative": True or False, # Indicates if this option is being negatively targeted.
"keyword": "A String", # Required. The keyword, for example `car insurance`.
#
# Positive keyword cannot be offensive word.
# Must be UTF-8 encoded with a maximum size of 255 bytes. Maximum number
# of characters is 80. Maximum number of words is 10.
},
"deviceMakeModelDetails": { # Assigned device make and model targeting option details. This will be # Device make and model details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_DEVICE_MAKE_MODEL`.
# populated in the
# device_make_model_details
# field when
# targeting_type is
# `TARGETING_TYPE_DEVICE_MAKE_MODEL`.
"negative": True or False, # Indicates if this option is being negatively targeted.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_DEVICE_MAKE_MODEL`.
"displayName": "A String", # Output only. The display name of the device make and model.
},
"digitalContentLabelExclusionDetails": { # Targeting details for digital content label. This will be # Digital content label details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`.
#
# Digital content labels are targeting exclusions. Advertiser level digital
# content label exclusions, if set, are always applied in serving (even
# though they aren't visible in line item settings). Line item settings can
# exclude content labels in addition to advertiser exclusions, but can't
# override them. A line item won't serve if all the digital content labels
# are excluded.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION`.
"excludedTargetingOptionId": "A String", # Required. ID of the digital content label to be EXCLUDED.
"contentRatingTier": "A String", # Output only. The display name of the digital content label rating tier.
},
"browserDetails": { # Details for assigned browser targeting option. This will be populated in # Browser details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_BROWSER`.
# the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_BROWSER`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_BROWSER`.
"displayName": "A String", # Output only. The display name of the browser.
"negative": True or False, # Indicates if this option is being negatively targeted. All assigned browser
# targeting options on the same line item must have the same value for this
# field.
},
"appCategoryDetails": { # Details for assigned app category targeting option. This will be # App category details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_APP_CATEGORY`.
# populated in the
# app_category_details field of
# an AssignedTargetingOption when
# targeting_type
# is `TARGETING_TYPE_APP_CATEGORY`.
"negative": True or False, # Indicates if this option is being negatively targeted.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_APP_CATEGORY`.
"displayName": "A String", # Output only. The display name of the app category.
},
"contentOutstreamPositionDetails": { # Assigned content outstream position targeting option details. This will be # Content outstream position details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION`.
# populated in the
# content_outstream_position_details
# field when
# targeting_type is
# `TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION`.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION`.
"contentOutstreamPosition": "A String", # Output only. The content outstream position.
},
"negativeKeywordListDetails": { # Targeting details for negative keyword list. This will be populated in the # Keyword details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_NEGATIVE_KEYWORD_LIST`.
#
# A maximum of 4 negative keyword lists can be assigned to a line item.
# details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_NEGATIVE_KEYWORD_LIST`.
"negativeKeywordListId": "A String", # Required. ID of the negative keyword list. Should refer to the
# negative_keyword_list_id
# field of a NegativeKeywordList resource.
},
"genderDetails": { # Details for assigned gender targeting option. This will be populated in # Gender details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_GENDER`.
# the details field of an AssignedTargetingOption when
# targeting_type is
# `TARTGETING_TYPE_GENDER`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_GENDER`.
"gender": "A String", # Output only. The gender of the audience.
},
"name": "A String", # Output only. The resource name for this assigned targeting option.
"inventorySourceDetails": { # Targeting details for inventory source. This will be # Inventory source details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_INVENTORY_SOURCE`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_INVENTORY_SOURCE`.
"inventorySourceId": "A String", # Required. ID of the inventory source. Should refer to the
# inventory_source_id field of an
# InventorySource resource.
},
"sensitiveCategoryExclusionDetails": { # Targeting details for sensitive category. This will be populated in the # Sensitive category details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION`.
#
# Sensitive categories are targeting exclusions. Advertiser level sensitive
# category exclusions, if set, are always applied in serving (even though
# they aren't visible in line item settings). Line item settings can
# exclude sensitive categories in addition to advertiser exclusions, but
# can't override them.
# details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION`.
"excludedTargetingOptionId": "A String", # Required. ID of the sensitive category to be EXCLUDED.
"sensitiveCategory": "A String", # Output only. An enum for the DV360 Sensitive category content classifier.
},
"audienceGroupDetails": { # Assigned audience group targeting option details. This will be populated in # Audience targeting details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_AUDIENCE_GROUP`.
# You can only target one audience group option per line item.
# the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_AUDIENCE_GROUP`.
# The relation between each group is UNION, except for
# excluded_first_and_third_party_audience_group and
# excluded_google_audience_group, of which COMPLEMENT is UNION'ed with other
# groups.
"includedFirstAndThirdPartyAudienceGroups": [ # The first and third party audience ids and recencies of included first
# and third party audience groups. Each first and third party audience group
# contains first and third party audience ids only.
# The relation between each first and third party audience group is
# INTERSECTION, and the result is UNION'ed with other audience groups.
# Repeated groups with same settings will be ignored.
{ # Details of first and third party audience group.
# All first and third party audience targeting settings are logically ‘OR’ of
# each other.
"settings": [ # Required. All first and third party audience targeting settings in first and
# third party audience group.
# Repeated settings with same id are not allowed.
{ # Details of first and third party audience targeting setting.
"recency": "A String", # The recency of the first and third party audience targeting setting.
# Only applicable to first party audiences, otherwise
# will be ignored. For more info, refer to
# https://support.google.com/displayvideo/answer/2949947#recency
# When unspecified, no recency limit will be used.
"firstAndThirdPartyAudienceId": "A String", # Required. First and third party audience id of the first and third party audience
# targeting setting. This id is
# first_and_third_party_audience_id.
},
],
},
],
"includedCombinedAudienceGroup": { # Details of combined audience group. # The combined audience ids of the included combined audience group.
# Contains combined audience ids only.
# All combined audience targeting settings are logically ‘OR’ of each other.
"settings": [ # Required. All combined audience targeting settings in combined audience group.
# Repeated settings with same id will be ignored.
# The number of combined audience settings should be no more than five, error
# will be thrown otherwise.
{ # Details of combined audience targeting setting.
"combinedAudienceId": "A String", # Required. Combined audience id of combined audience targeting setting.
# This id is combined_audience_id.
},
],
},
"includedCustomListGroup": { # Details of custom list group. # The custom list ids of the included custom list group.
# Contains custom list ids only.
# All custom list targeting settings are logically ‘OR’ of each other.
"settings": [ # Required. All custom list targeting settings in custom list group.
# Repeated settings with same id will be ignored.
{ # Details of custom list targeting setting.
"customListId": "A String", # Required. Custom id of custom list targeting setting.
# This id is custom_list_id.
},
],
},
"excludedFirstAndThirdPartyAudienceGroup": { # Details of first and third party audience group. # The first and third party audience ids and recencies of the excluded
# first and third party audience group. Used for negative targeting. Its
# COMPLEMENT is used to UNION other audience groups.
# All first and third party audience targeting settings are logically ‘OR’ of
# each other.
"settings": [ # Required. All first and third party audience targeting settings in first and
# third party audience group.
# Repeated settings with same id are not allowed.
{ # Details of first and third party audience targeting setting.
"recency": "A String", # The recency of the first and third party audience targeting setting.
# Only applicable to first party audiences, otherwise
# will be ignored. For more info, refer to
# https://support.google.com/displayvideo/answer/2949947#recency
# When unspecified, no recency limit will be used.
"firstAndThirdPartyAudienceId": "A String", # Required. First and third party audience id of the first and third party audience
# targeting setting. This id is
# first_and_third_party_audience_id.
},
],
},
"includedGoogleAudienceGroup": { # Details of Google audience group. # The Google audience ids of the included Google audience group.
# Contains Google audience ids only.
# All Google audience targeting settings are logically ‘OR’ of each other.
"settings": [ # Required. All Google audience targeting settings in Google audience group.
# Repeated settings with same id will be ignored.
{ # Details of Google audience targeting setting.
"googleAudienceId": "A String", # Required. Google audience id of the Google audience targeting setting.
# This id is google_audience_id.
},
],
},
"excludedGoogleAudienceGroup": { # Details of Google audience group. # The Google audience ids of the excluded Google audience group.
# Used for negative targeting. It's COMPLEMENT is used to UNION other
# audience groups.
# Only contains Affinity, In-market and Installed-apps type Google audiences.
# All items are logically ‘OR’ of each other.
# All Google audience targeting settings are logically ‘OR’ of each other.
"settings": [ # Required. All Google audience targeting settings in Google audience group.
# Repeated settings with same id will be ignored.
{ # Details of Google audience targeting setting.
"googleAudienceId": "A String", # Required. Google audience id of the Google audience targeting setting.
# This id is google_audience_id.
},
],
},
},
"userRewardedContentDetails": { # User rewarded content targeting option details. This will be populated in # User rewarded content details. This field will be populated when the
# TargetingType is
# `TARGETING_TYPE_USER_REWARDED_CONTENT`.
# the
# user_rewarded_content_details
# field when
# targeting_type is
# `TARGETING_TYPE_USER_REWARDED_CONTENT`.
"userRewardedContent": "A String", # Output only. User rewarded content status for video ads.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_USER_REWARDED_CONTENT`.
},
"languageDetails": { # Details for assigned language targeting option. This will be populated in the # Language details. This field will be populated when the TargetingType is
# `TARGETING_TYPE_LANGUAGE`.
# details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_LANGUAGE`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_LANGUAGE`.
"displayName": "A String", # Output only. The display name of the language (e.g., "French").
"negative": True or False, # Indicates if this option is being negatively targeted. All assigned
# language targeting options on the same line item must have the same value
# for this field.
},
"authorizedSellerStatusDetails": { # Represents an assigned authorized seller status. This will be populated in # Authorized seller status details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_AUTHORIZED_SELLER_STATUS`.
#
# You can only target one authorized seller status option per line item.
#
# If a line item doesn't have an authorized seller status option, all
# authorized sellers indicated as DIRECT or RESELLER in the ads.txt file
# are targeted by default.
# the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_AUTHORIZED_SELLER_STATUS`.
"authorizedSellerStatus": "A String", # Output only. The authorized seller status to target.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_AUTHORIZED_SELLER_STATUS`.
},
"dayAndTimeDetails": { # Representation of a segment of time defined on a specific day of the week and # Day and time details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_DAY_AND_TIME`.
# with a start and end time.
# The time represented by `start_hour` must be before the time represented by
# `end_hour`.
"dayOfWeek": "A String", # Required. The day of the week for this day and time targeting setting.
"startHour": 42, # Required. The start hour for day and time targeting. Must be between 0 (start of day)
# and 23 (1 hour before end of day).
"endHour": 42, # Required. The end hour for day and time targeting. Must be between 1 (1 hour after
# start of day) and 24 (end of day).
"timeZoneResolution": "A String", # Required. The mechanism used to determine which timezone to use for this day and time
# targeting setting.
},
"inheritance": "A String", # Output only. The inheritance status of the assigned targeting option.
"environmentDetails": { # Assigned environment targeting option details. This will be populated # Environment details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_ENVIRONMENT`.
# in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_ENVIRONMENT`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_ENVIRONMENT` (e.g., "508010"
# for targeting the `ENVIRONMENT_WEB_OPTIMIZED` option).
"environment": "A String", # Output only. The serving environment.
},
"geoRegionDetails": { # Details for assigned geographic region targeting option. This will be # Geographic region details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_GEO_REGION`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_GEO_REGION`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_GEO_REGION`.
"displayName": "A String", # Output only. The display name of the geographic region (e.g., "Ontario, Canada").
"geoRegionType": "A String", # Output only. The type of geographic region targeting.
"negative": True or False, # Indicates if this option is being negatively targeted.
},
"deviceTypeDetails": { # Targeting details for device type. This will be # Device Type details. This field will be populated when the
# TargetingType is
# `TARGETING_TYPE_DEVICE_TYPE`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_DEVICE_TYPE`.
"targetingOptionId": "A String", # Required. ID of the device type.
"deviceType": "A String", # Output only. The display name of the device type.
},
"exchangeDetails": { # Details for assigned exchange targeting option. This will be populated in # Exchange details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_EXCHANGE`.
# the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_EXCHANGE`.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_EXCHANGE`.
},
"assignedTargetingOptionId": "A String", # Output only. The unique ID of the assigned targeting option. The ID is only unique
# within a given line item and targeting type. It may be reused in other
# contexts.
"householdIncomeDetails": { # Details for assigned household income targeting option. This will be # Household income details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_HOUSEHOLD_INCOME`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_HOUSEHOLD_INCOME`.
"householdIncome": "A String", # Output only. The household income of the audience.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_HOUSEHOLD_INCOME`.
},
"contentInstreamPositionDetails": { # Assigned content instream position targeting option details. This will be # Content instream position details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_CONTENT_INSTREAM_POSITION`.
# populated in the
# content_instream_position_details
# field when
# targeting_type is
# `TARGETING_TYPE_CONTENT_INSTREAM_POSITION`.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_CONTENT_INSTREAM_POSITION`.
"contentInstreamPosition": "A String", # Output only. The content instream position for video or audio ads.
},
"categoryDetails": { # Assigned category targeting option details. This will be populated in the # Category details. This field will be populated when the TargetingType is
# `TARGETING_TYPE_CATEGORY`.
#
# Targeting a category will also target its subcategories. If a category is
# excluded from targeting and a subcategory is included, the exclusion will
# take precedence.
# category_details field when
# targeting_type is
# `TARGETING_TYPE_CATEGORY`.
"targetingOptionId": "A String", # Required. The targeting_option_id field when
# targeting_type is
# `TARGETING_TYPE_CATEGORY`.
"displayName": "A String", # Output only. The display name of the category.
"negative": True or False, # Indicates if this option is being negatively targeted.
},
"inventorySourceGroupDetails": { # Targeting details for inventory source group. This will be # Inventory source group details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_INVENTORY_SOURCE_GROUP`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_INVENTORY_SOURCE_GROUP`.
"inventorySourceGroupId": "A String", # Required. ID of the inventory source group. Should refer to the
# inventory_source_group_id
# field of an InventorySourceGroup resource.
},
"regionalLocationListDetails": { # Targeting details for regional location list. This will be # Regional location list details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_REGIONAL_LOCATION_LIST`.
# populated in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_REGIONAL_LOCATION_LIST`.
"regionalLocationListId": "A String", # Required. ID of the regional location list. Should refer to the
# location_list_id field of a
# LocationList resource whose type is `TARGETING_LOCATION_TYPE_REGIONAL`.
"negative": True or False, # Indicates if this option is being negatively targeted.
},
"carrierAndIspDetails": { # Details for assigned carrier and ISP targeting option. This will be populated # Carrier and ISP details. This field will be populated when the
# TargetingType is `TARGETING_TYPE_CARRIER_AND_ISP`.
# in the details field of an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_CARRIER_AND_ISP`.
"negative": True or False, # Indicates if this option is being negatively targeted. All assigned carrier
# and ISP targeting options on the same line item must have the same value
# for this field.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_CARRIER_AND_ISP`.
"displayName": "A String", # Output only. The display name of the carrier or ISP.
},
"viewabilityDetails": { # Assigned viewability targeting option details. This will be populated in the # Viewability details. This field will be populated when the TargetingType
# is `TARGETING_TYPE_VIEWABILITY`.
#
# You can only target one viewability option per line item.
# viewability_details field of
# an AssignedTargetingOption when
# targeting_type is
# `TARGETING_TYPE_VIEWABILITY`.
"viewability": "A String", # Output only. The predicted viewability percentage.
"targetingOptionId": "A String", # Required. The targeting_option_id of a
# TargetingOption of type `TARGETING_TYPE_VIEWABILITY` (e.g., "509010"
# for targeting the `VIEWABILITY_10_PERCENT_OR_MORE` option).
},
},
],
"nextPageToken": "A String", # A token identifying the next page of results. This value should be
# specified as the
# pageToken in a
# subsequent ListLineItemAssignedTargetingOptionsRequest to fetch the
# next page of results. This token will be absent if there are no more
# assigned_targeting_options
# to return.
}
list_next(previous_request, previous_response)
Retrieves the next page of results.
Args:
previous_request: The request for the previous page. (required)
previous_response: The response from the request for the previous page. (required)
Returns:
A request object that you can call 'execute()' on to request the next
page. Returns None if there are no more items in the collection.