REST Resource: targetingTypes.targetingOptions

• 资源：TargetingOption
  • JSON 表示法
• DigitalContentLabelTargetingOptionDetails
  • JSON 表示法
• SensitiveCategoryTargetingOptionDetails
  • JSON 表示法
• AppCategoryTargetingOptionDetails
  • JSON 表示法
• OnScreenPositionTargetingOptionDetails
  • JSON 表示法
• ContentOutstreamPositionTargetingOptionDetails
  • JSON 表示法
• ContentInstreamPositionTargetingOptionDetails
  • JSON 表示法
• VideoPlayerSizeTargetingOptionDetails
  • JSON 表示法
• AgeRangeTargetingOptionDetails
  • JSON 表示法
• ParentalStatusTargetingOptionDetails
  • JSON 表示法
• UserRewardedContentTargetingOptionDetails
  • JSON 表示法
• HouseholdIncomeTargetingOptionDetails
  • JSON 表示法
• GenderTargetingOptionDetails
  • JSON 表示法
• DeviceTypeTargetingOptionDetails
  • JSON 表示法
• BrowserTargetingOptionDetails
  • JSON 表示法
• CarrierAndIspTargetingOptionDetails
  • JSON 表示法
• CarrierAndIspType
• EnvironmentTargetingOptionDetails
  • JSON 表示法
• OperatingSystemTargetingOptionDetails
  • JSON 表示法
• DeviceMakeModelTargetingOptionDetails
  • JSON 表示法
• ViewabilityTargetingOptionDetails
  • JSON 表示法
• CategoryTargetingOptionDetails
  • JSON 表示法
• LanguageTargetingOptionDetails
  • JSON 表示法
• AuthorizedSellerStatusTargetingOptionDetails
  • JSON 表示法
• GeoRegionTargetingOptionDetails
  • JSON 表示法
• ExchangeTargetingOptionDetails
  • JSON 表示法
• SubExchangeTargetingOptionDetails
  • JSON 表示法
• PoiTargetingOptionDetails
  • JSON 表示法
• BusinessChainTargetingOptionDetails
  • JSON 表示法
• ContentDurationTargetingOptionDetails
  • JSON 表示法
• ContentStreamTypeTargetingOptionDetails
  • JSON 表示法
• NativeContentPositionTargetingOptionDetails
  • JSON 表示法
• OmidTargetingOptionDetails
  • JSON 表示法
• AudioContentTypeTargetingOptionDetails
  • JSON 表示法
• ContentGenreTargetingOptionDetails
  • JSON 表示法
• 方法

资源：TargetingOption

表示单个定位选项，即 DV360 中的可定位概念。

JSON 表示法

{ "name": string, "targetingOptionId": string, "targetingType": enum (TargetingType), // Union field details can be only one of the following: "digitalContentLabelDetails": { object (DigitalContentLabelTargetingOptionDetails) }, "sensitiveCategoryDetails": { object (SensitiveCategoryTargetingOptionDetails) }, "appCategoryDetails": { object (AppCategoryTargetingOptionDetails) }, "onScreenPositionDetails": { object (OnScreenPositionTargetingOptionDetails) }, "contentOutstreamPositionDetails": { object (ContentOutstreamPositionTargetingOptionDetails) }, "contentInstreamPositionDetails": { object (ContentInstreamPositionTargetingOptionDetails) }, "videoPlayerSizeDetails": { object (VideoPlayerSizeTargetingOptionDetails) }, "ageRangeDetails": { object (AgeRangeTargetingOptionDetails) }, "parentalStatusDetails": { object (ParentalStatusTargetingOptionDetails) }, "userRewardedContentDetails": { object (UserRewardedContentTargetingOptionDetails) }, "householdIncomeDetails": { object (HouseholdIncomeTargetingOptionDetails) }, "genderDetails": { object (GenderTargetingOptionDetails) }, "deviceTypeDetails": { object (DeviceTypeTargetingOptionDetails) }, "browserDetails": { object (BrowserTargetingOptionDetails) }, "carrierAndIspDetails": { object (CarrierAndIspTargetingOptionDetails) }, "environmentDetails": { object (EnvironmentTargetingOptionDetails) }, "operatingSystemDetails": { object (OperatingSystemTargetingOptionDetails) }, "deviceMakeModelDetails": { object (DeviceMakeModelTargetingOptionDetails) }, "viewabilityDetails": { object (ViewabilityTargetingOptionDetails) }, "categoryDetails": { object (CategoryTargetingOptionDetails) }, "languageDetails": { object (LanguageTargetingOptionDetails) }, "authorizedSellerStatusDetails": { object (AuthorizedSellerStatusTargetingOptionDetails) }, "geoRegionDetails": { object (GeoRegionTargetingOptionDetails) }, "exchangeDetails": { object (ExchangeTargetingOptionDetails) }, "subExchangeDetails": { object (SubExchangeTargetingOptionDetails) }, "poiDetails": { object (PoiTargetingOptionDetails) }, "businessChainDetails": { object (BusinessChainTargetingOptionDetails) }, "contentDurationDetails": { object (ContentDurationTargetingOptionDetails) }, "contentStreamTypeDetails": { object (ContentStreamTypeTargetingOptionDetails) }, "nativeContentPositionDetails": { object (NativeContentPositionTargetingOptionDetails) }, "omidDetails": { object (OmidTargetingOptionDetails) }, "audioContentTypeDetails": { object (AudioContentTypeTargetingOptionDetails) }, "contentGenreDetails": { object (ContentGenreTargetingOptionDetails) } // End of list of possible types for union field details. }

字段
name	string 仅限输出。此定位选项的资源名称。
targetingOptionId	string 仅限输出。此定位选项的唯一标识符。元组 {targetingType, targetingOptionId} 将是唯一的。
targetingType	enum (TargetingType) 仅限输出。此定位选项的类型。
联合字段 details。有关定位选项的详细信息。只能填写详情中的一个字段，并且该字段必须与 targeting_type 相对应；details 只能是以下字段之一：
digitalContentLabelDetails	object (DigitalContentLabelTargetingOptionDetails) 数字内容标签详情。
sensitiveCategoryDetails	object (SensitiveCategoryTargetingOptionDetails) 敏感类别详情。
appCategoryDetails	object (AppCategoryTargetingOptionDetails) 应用类别详细信息。
onScreenPositionDetails	object (OnScreenPositionTargetingOptionDetails) 屏幕上的位置详细信息。
contentOutstreamPositionDetails	object (ContentOutstreamPositionTargetingOptionDetails) 内容外部直播位置详情。
contentInstreamPositionDetails	object (ContentInstreamPositionTargetingOptionDetails) 内容插播广告位置详情。
videoPlayerSizeDetails	object (VideoPlayerSizeTargetingOptionDetails) 视频播放器尺寸详情。
ageRangeDetails	object (AgeRangeTargetingOptionDetails) 年龄段详情。
parentalStatusDetails	object (ParentalStatusTargetingOptionDetails) 育儿状况详情。
userRewardedContentDetails	object (UserRewardedContentTargetingOptionDetails) 用户奖励内容的详细信息。
householdIncomeDetails	object (HouseholdIncomeTargetingOptionDetails) 家庭收入详细信息。
genderDetails	object (GenderTargetingOptionDetails) 性别详细信息。
deviceTypeDetails	object (DeviceTypeTargetingOptionDetails) 设备类型详情。
browserDetails	object (BrowserTargetingOptionDetails) 浏览器详细信息。
carrierAndIspDetails	object (CarrierAndIspTargetingOptionDetails) 运营商和 ISP 详细信息。
environmentDetails	object (EnvironmentTargetingOptionDetails) 环境详情。
operatingSystemDetails	object (OperatingSystemTargetingOptionDetails) 操作系统资源详情。
deviceMakeModelDetails	object (DeviceMakeModelTargetingOptionDetails) 设备品牌和型号资源详情。
viewabilityDetails	object (ViewabilityTargetingOptionDetails) 可见度资源详情。
categoryDetails	object (CategoryTargetingOptionDetails) 类别资源详情。
languageDetails	object (LanguageTargetingOptionDetails) 语言资源详细信息。
authorizedSellerStatusDetails	object (AuthorizedSellerStatusTargetingOptionDetails) 授权卖方状态资源详情。
geoRegionDetails	object (GeoRegionTargetingOptionDetails) 地理区域资源详细信息。
exchangeDetails	object (ExchangeTargetingOptionDetails) 换货详情。
subExchangeDetails	object (SubExchangeTargetingOptionDetails) 子广告交易平台详细信息。
poiDetails	object (PoiTargetingOptionDetails) 地图注点资源详情。
businessChainDetails	object (BusinessChainTargetingOptionDetails) 连锁企业资源详情。
contentDurationDetails	object (ContentDurationTargetingOptionDetails) 内容时长资源详细信息。
contentStreamTypeDetails	object (ContentStreamTypeTargetingOptionDetails) 内容流类型资源详细信息。
nativeContentPositionDetails	object (NativeContentPositionTargetingOptionDetails) 原生内容位置详细信息。
omidDetails	object (OmidTargetingOptionDetails) Open Measurement 启用了广告资源详情。
audioContentTypeDetails	object (AudioContentTypeTargetingOptionDetails) 音频内容类型详情。
contentGenreDetails	object (ContentGenreTargetingOptionDetails) 内容类型资源详细信息。

DigitalContentLabelTargetingOptionDetails

表示可定位的数字内容标签分级层级。当 targetingType 为 TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION 时，系统会在 TargetingOption 的 digitalContentLabelDetails 字段中填充此值。

JSON 表示法
{ "contentRatingTier": enum (ContentRatingTier) }

字段
contentRatingTier	enum (ContentRatingTier) 仅限输出。内容标签品牌保障等级的枚举。

SensitiveCategoryTargetingOptionDetails

表示可定位的敏感类别。当 targetingType 为 TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION 时，系统会在 TargetingOption 的 sensitiveCategoryDetails 字段中填充此值。

JSON 表示法
{ "sensitiveCategory": enum (SensitiveCategory) }

字段
sensitiveCategory	enum (SensitiveCategory) 仅限输出。DV360 敏感类别内容分类器的枚举。

AppCategoryTargetingOptionDetails

表示可定位的应用集合。借助集合，您可以定位由平台维护的相关应用的动态群组，例如 All Apps/Google Play/Games。当 targetingType 为 TARGETING_TYPE_APP_CATEGORY 时，系统会在 appCategoryDetails 字段中填充此值。

JSON 表示法
{ "displayName": string }

字段
displayName	string 仅限输出。应用集合的名称。

OnScreenPositionTargetingOptionDetails

表示可定位的屏幕位置，可供展示广告和视频广告使用。当 targetingType 为 TARGETING_TYPE_ON_SCREEN_POSITION 时，系统会在 onScreenPositionDetails 字段中填充此值。

JSON 表示法
{ "onScreenPosition": enum (OnScreenPosition) }

字段
onScreenPosition	enum (OnScreenPosition) 仅限输出。在屏幕上的位置。

ContentOutstreamPositionTargetingOptionDetails

表示可定位的内容外播位置，可供展示广告和视频广告使用。当 targetingType 为 TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION 时，系统会在 contentOutstreamPositionDetails 字段中填充此值。

JSON 表示法
{ "contentOutstreamPosition": enum (ContentOutstreamPosition) }

字段
contentOutstreamPosition	enum (ContentOutstreamPosition) 仅限输出。内容的外播位置。

ContentInstreamPositionTargetingOptionDetails

表示可定位的内容插播位置，可供视频和音频广告使用。当 targetingType 为 TARGETING_TYPE_CONTENT_INSTREAM_POSITION 时，系统会在 contentInstreamPositionDetails 字段中填充此值。

JSON 表示法
{ "contentInstreamPosition": enum (ContentInstreamPosition) }

字段
contentInstreamPosition	enum (ContentInstreamPosition) 仅限输出。内容插播位置。

VideoPlayerSizeTargetingOptionDetails

表示可定位到的视频播放器尺寸。当 targetingType 为 TARGETING_TYPE_VIDEO_PLAYER_SIZE 时，系统会在 videoPlayerSizeDetails 字段中填充此值。

JSON 表示法
{ "videoPlayerSize": enum (VideoPlayerSize) }

字段
videoPlayerSize	enum (VideoPlayerSize) 仅限输出。视频播放器尺寸。

AgeRangeTargetingOptionDetails

表示可定位的年龄段。当 targetingType 为 TARGETING_TYPE_AGE_RANGE 时，将填充 ageRangeDetails 字段。

JSON 表示法
{ "ageRange": enum (AgeRange) }

字段
ageRange	enum (AgeRange) 仅限输出。观众的年龄段。

ParentalStatusTargetingOptionDetails

表示可定位的生育情况。当 targetingType 为 TARGETING_TYPE_PARENTAL_STATUS 时，此值将填充到 TargetingOption 的 parentalStatusDetails 字段中。

JSON 表示法
{ "parentalStatus": enum (ParentalStatus) }

字段
parentalStatus	enum (ParentalStatus) 仅限输出。受众群体的育儿状况。

UserRewardedContentTargetingOptionDetails

仅表示可定位的用户激励内容状态（适用于视频广告）。当 targetingType 为 TARGETING_TYPE_USER_REWARDED_CONTENT 时，将填充 userRewardedContentDetails 字段。

JSON 表示法
{ "userRewardedContent": enum (UserRewardedContent) }

字段
userRewardedContent	enum (UserRewardedContent) 仅限输出。视频广告的会激励用户的内容状态。

HouseholdIncomeTargetingOptionDetails

表示可定位的家庭收入。当 targetingType 为 TARGETING_TYPE_HOUSEHOLD_INCOME 时，系统会在 TargetingOption 的 householdIncomeDetails 字段中填充此值。

JSON 表示法
{ "householdIncome": enum (HouseholdIncome) }

字段
householdIncome	enum (HouseholdIncome) 仅限输出。受众群体的家庭收入。

GenderTargetingOptionDetails

表示可定位到的性别。当 targetingType 为 TARGETING_TYPE_GENDER 时，此值将填充到 TargetingOption 的 genderDetails 字段中。

JSON 表示法
{ "gender": enum (Gender) }

字段
gender	enum (Gender) 仅限输出。受众群体的性别。

DeviceTypeTargetingOptionDetails

表示可定位到的设备类型。当 targetingType 为 TARGETING_TYPE_DEVICE_TYPE 时，系统会在 TargetingOption 的 deviceTypeDetails 字段中填充此值。

JSON 表示法
{ "deviceType": enum (DeviceType) }

字段
deviceType	enum (DeviceType) 仅限输出。用于定位的设备类型。

BrowserTargetingOptionDetails

表示可定位的浏览器。当 targetingType 为 TARGETING_TYPE_BROWSER 时，系统会在 browserDetails 字段中填充此值。

JSON 表示法
{ "displayName": string }

字段
displayName	string 仅限输出。浏览器的显示名称。

CarrierAndIspTargetingOptionDetails

表示可定位到的运营商或 ISP。当 targetingType 为 TARGETING_TYPE_CARRIER_AND_ISP 时，系统会在 TargetingOption 的 carrierAndIspDetails 字段中填充此值。

JSON 表示法
{ "displayName": string, "type": enum (CarrierAndIspType) }

字段
displayName	string 仅限输出。运营商或 ISP 的显示名称。
type	enum (CarrierAndIspType) 仅限输出。类型，表示是运营商还是 ISP。

CarrierAndIspType

CarrierAndIspTargetingOption 的类型。

枚举
CARRIER_AND_ISP_TYPE_UNSPECIFIED	在此版本中，如果未指定类型或类型未知，则使用默认值。
CARRIER_AND_ISP_TYPE_ISP	表示此定位资源是指 ISP。
CARRIER_AND_ISP_TYPE_CARRIER	表示此定位资源是指移动运营商。

EnvironmentTargetingOptionDetails

表示可定位的环境。当 targetingType 为 TARGETING_TYPE_ENVIRONMENT 时，系统会在 TargetingOption 的 environmentDetails 字段中填充此值。

JSON 表示法
{ "environment": enum (Environment) }

字段
environment	enum (Environment) 仅限输出。投放环境。

OperatingSystemTargetingOptionDetails

表示可定位到的操作系统。当 targetingType 为 TARGETING_TYPE_OPERATING_SYSTEM 时，系统会在 TargetingOption 的 operatingSystemDetails 字段中填充此值。

JSON 表示法
{ "displayName": string }

字段
displayName	string 仅限输出。操作系统的显示名称。

DeviceMakeModelTargetingOptionDetails

表示可定位的设备品牌和型号。当 targetingType 为 TARGETING_TYPE_DEVICE_MAKE_MODEL 时，系统会在 TargetingOption 的 deviceMakeModelDetails 字段中填充此值。

JSON 表示法
{ "displayName": string }

字段
displayName	string 仅限输出。设备品牌和型号的显示名称。

ViewabilityTargetingOptionDetails

表示可定位的可见度。当 targetingType 为 TARGETING_TYPE_VIEWABILITY 时，系统将在 TargetOption 的 viewabilityDetails 字段中填充此字段。

JSON 表示法
{ "viewability": enum (Viewability) }

字段
viewability	enum (Viewability) 仅限输出。预计的可见度百分比。

CategoryTargetingOptionDetails

表示可定位的类别。当 targetingType 为 TARGETING_TYPE_CATEGORY 时，系统会在 TargetingOption 的 categoryDetails 字段中填充此值。

JSON 表示法
{ "displayName": string }

字段
displayName	string 仅限输出。类别的显示名称。

LanguageTargetingOptionDetails

表示可定位的语言。当 targetingType 为 TARGETING_TYPE_LANGUAGE 时，系统会在 languageDetails 字段中填充此值。

JSON 表示法
{ "displayName": string }

字段
displayName	string 仅限输出。语言的显示名称（例如：“法语”）。

AuthorizedSellerStatusTargetingOptionDetails

表示可定位到的授权卖家状态。当 targetingType 为 TARGETING_TYPE_AUTHORIZED_SELLER_STATUS 时，系统会在 authorizedSellerStatusDetails 字段中填充此值。

JSON 表示法
{ "authorizedSellerStatus": enum (AuthorizedSellerStatus) }

字段
authorizedSellerStatus	enum (AuthorizedSellerStatus) 仅限输出。授权卖方状态。

GeoRegionTargetingOptionDetails

表示可定位的地理区域。当 targetingType 为 TARGETING_TYPE_GEO_REGION 时，系统会在 geoRegionDetails 字段中填充此值。

JSON 表示法
{ "displayName": string, "geoRegionType": enum (GeoRegionType) }

字段
displayName	string 仅限输出。地理区域的显示名称（例如，“安大略省，加拿大”）。
geoRegionType	enum (GeoRegionType) 仅限输出。地理区域定位的类型。

ExchangeTargetingOptionDetails

表示可定位到的广告交易平台。当 targetingType 为 TARGETING_TYPE_EXCHANGE 时，系统将在 TargetOption 的 exchangeDetails 字段中填充此字段。

JSON 表示法
{ "exchange": enum (Exchange) }

字段
exchange	enum (Exchange) 仅限输出。广告交易平台的类型。

SubExchangeTargetingOptionDetails

表示可定位的子广告交易平台。当 targetingType 为 TARGETING_TYPE_SUB_EXCHANGE 时，系统会在 TargetingOption 的 subExchangeDetails 字段中填充此值。

JSON 表示法
{ "displayName": string }

字段
displayName	string 仅限输出。子广告交易平台的显示名称。

PoiTargetingOptionDetails

表示可定位的地图注点 (POI)。当 targetingType 为 TARGETING_TYPE_POI 时，系统会在 poiDetails 字段中填充此值。

JSON 表示法
{ "latitude": number, "longitude": number, "displayName": string }

字段
latitude	number 仅限输出。地图注点的纬度，四舍五入到小数点后 6 位。
longitude	number 仅限输出。地图注点的经度（四舍五入到小数点后 6 位）。
displayName	string 仅限输出。地图注点的显示名称（例如“时代广场”“太空针塔”），后跟其完整地址（如果有）。

BusinessChainTargetingOptionDetails

表示地理区域内可定位到的商业连锁。当 targetingType 为 TARGETING_TYPE_BUSINESS_CHAIN 时，系统会在 businessChainDetails 字段中填充此值。

JSON 表示法
{ "businessChain": string, "geoRegion": string, "geoRegionType": enum (GeoRegionType) }

字段
businessChain	string 仅限输出。商家连锁的显示名称，例如“肯德基”“美国银行”。
geoRegion	string 仅限输出。地理区域的显示名，例如“加拿大安大略省”。
geoRegionType	enum (GeoRegionType) 仅限输出。地理区域的类型。

ContentDurationTargetingOptionDetails

表示可定位的内容时长。当 targetingType 为 TARGETING_TYPE_CONTENT_DURATION 时，将填充 contentDurationDetails 字段。

JSON 表示法
{ "contentDuration": enum (ContentDuration) }

字段
contentDuration	enum (ContentDuration) 仅限输出。内容时长。

ContentStreamTypeTargetingOptionDetails

表示可定位的内容流类型。当 targetingType 为 TARGETING_TYPE_CONTENT_STREAM_TYPE 时，将填充 contentStreamTypeDetails 字段。

JSON 表示法
{ "contentStreamType": enum (ContentStreamType) }

字段
contentStreamType	enum (ContentStreamType) 仅限输出。内容流类型。

NativeContentPositionTargetingOptionDetails

表示可定位到的原生内容展示位置。当 targetingType 为 TARGETING_TYPE_NATIVE_CONTENT_POSITION 时，系统会在 nativeContentPositionDetails 字段中填充此值。

JSON 表示法
{ "contentPosition": enum (NativeContentPosition) }

字段
contentPosition	enum (NativeContentPosition) 仅限输出。内容位置。

OmidTargetingOptionDetails

表示启用了 Open Measurement 的可定位广告资源类型。当 targetingType 为 TARGETING_TYPE_OMID 时，系统会在 omidDetails 字段中填充此值。

JSON 表示法
{ "omid": enum (Omid) }

字段
omid	enum (Omid) 仅限输出。已启用 Open Measurement 的广告资源的类型。

AudioContentTypeTargetingOptionDetails

表示可定位到的音频内容类型。当 targetingType 为 TARGETING_TYPE_AUDIO_CONTENT_TYPE 时，系统会在 audioContentTypeDetails 字段中填充此值。

JSON 表示法
{ "audioContentType": enum (AudioContentType) }

字段
audioContentType	enum (AudioContentType) 仅限输出。音频内容类型。

ContentGenreTargetingOptionDetails

表示可定位的内容类型。当 targetingType 为 TARGETING_TYPE_CONTENT_GENRE 时，系统会在 contentGenreDetails 字段中填充此值。

JSON 表示法
{ "displayName": string }

字段
displayName	string 仅限输出。内容类型的显示名称

方法
get	获取单个定位选项。
list	列出给定类型的定位选项。
search	根据给定的搜索字词搜索给定类型的定位选项。