REST Resource: targetingTypes.targetingOptions

资源：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)
  },
  "contentThemeDetails": {
    object (ContentThemeTargetingOptionDetails)
  },
  "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)

敏感类别的详细信息。
contentThemeDetails

object (ContentThemeTargetingOptionDetails)

内容主题详细信息。
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)

POI 资源详细信息。
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 敏感类别内容分类器的枚举。

ContentThemeTargetingOptionDetails

表示可定位的内容主题。当 targetingType 为 TARGETING_TYPE_CONTENT_THEME_EXCLUSION 时，此值将填充到 TargetingOption 的 contentThemeDetails 字段中。

JSON 表示法 
{
  "contentTheme": enum (ContentTheme)
}
字段
contentTheme

enum (ContentTheme)

仅限输出。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 时，此字段将填充到 TargetingOption 的 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 时，此字段将填充到 TargetingOption 的 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

仅限输出。POI 的纬度，四舍五入到小数点后 6 位。
longitude

number

仅限输出。地图注点的经度，四舍五入到小数点后 6 位。
displayName

string

仅限输出。POI 的显示名称（例如“时代广场”“太空针塔”），后跟其完整地址（如有）。

BusinessChainTargetingOptionDetails

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

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

string

仅限输出。连锁企业的显示名称，例如“KFC”“Chase Bank”。
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

 列出指定类型的定位选项。
根据给定的搜索字词搜索给定类型的定位选项。