REST Resource: advertisers.campaigns.targetingTypes.assignedTargetingOptions

资源：AssignTargetingOption

单个分配的定位选项，用于定义具有定位设置的实体的定位选项状态。

JSON 表示法 
{
  "name": string,
  "assignedTargetingOptionId": string,
  "assignedTargetingOptionIdAlias": string,
  "targetingType": enum (TargetingType),
  "inheritance": enum (Inheritance),

  // Union field details can be only one of the following:
  "channelDetails": {
    object (ChannelAssignedTargetingOptionDetails)
  },
  "appCategoryDetails": {
    object (AppCategoryAssignedTargetingOptionDetails)
  },
  "appDetails": {
    object (AppAssignedTargetingOptionDetails)
  },
  "urlDetails": {
    object (UrlAssignedTargetingOptionDetails)
  },
  "dayAndTimeDetails": {
    object (DayAndTimeAssignedTargetingOptionDetails)
  },
  "ageRangeDetails": {
    object (AgeRangeAssignedTargetingOptionDetails)
  },
  "regionalLocationListDetails": {
    object (RegionalLocationListAssignedTargetingOptionDetails)
  },
  "proximityLocationListDetails": {
    object (ProximityLocationListAssignedTargetingOptionDetails)
  },
  "genderDetails": {
    object (GenderAssignedTargetingOptionDetails)
  },
  "videoPlayerSizeDetails": {
    object (VideoPlayerSizeAssignedTargetingOptionDetails)
  },
  "userRewardedContentDetails": {
    object (UserRewardedContentAssignedTargetingOptionDetails)
  },
  "parentalStatusDetails": {
    object (ParentalStatusAssignedTargetingOptionDetails)
  },
  "contentInstreamPositionDetails": {
    object (ContentInstreamPositionAssignedTargetingOptionDetails)
  },
  "contentOutstreamPositionDetails": {
    object (ContentOutstreamPositionAssignedTargetingOptionDetails)
  },
  "deviceTypeDetails": {
    object (DeviceTypeAssignedTargetingOptionDetails)
  },
  "audienceGroupDetails": {
    object (AudienceGroupAssignedTargetingOptionDetails)
  },
  "browserDetails": {
    object (BrowserAssignedTargetingOptionDetails)
  },
  "householdIncomeDetails": {
    object (HouseholdIncomeAssignedTargetingOptionDetails)
  },
  "onScreenPositionDetails": {
    object (OnScreenPositionAssignedTargetingOptionDetails)
  },
  "carrierAndIspDetails": {
    object (CarrierAndIspAssignedTargetingOptionDetails)
  },
  "keywordDetails": {
    object (KeywordAssignedTargetingOptionDetails)
  },
  "negativeKeywordListDetails": {
    object (NegativeKeywordListAssignedTargetingOptionDetails)
  },
  "operatingSystemDetails": {
    object (OperatingSystemAssignedTargetingOptionDetails)
  },
  "deviceMakeModelDetails": {
    object (DeviceMakeModelAssignedTargetingOptionDetails)
  },
  "environmentDetails": {
    object (EnvironmentAssignedTargetingOptionDetails)
  },
  "inventorySourceDetails": {
    object (InventorySourceAssignedTargetingOptionDetails)
  },
  "categoryDetails": {
    object (CategoryAssignedTargetingOptionDetails)
  },
  "viewabilityDetails": {
    object (ViewabilityAssignedTargetingOptionDetails)
  },
  "authorizedSellerStatusDetails": {
    object (AuthorizedSellerStatusAssignedTargetingOptionDetails)
  },
  "languageDetails": {
    object (LanguageAssignedTargetingOptionDetails)
  },
  "geoRegionDetails": {
    object (GeoRegionAssignedTargetingOptionDetails)
  },
  "inventorySourceGroupDetails": {
    object (InventorySourceGroupAssignedTargetingOptionDetails)
  },
  "digitalContentLabelExclusionDetails": {
    object (DigitalContentLabelAssignedTargetingOptionDetails)
  },
  "sensitiveCategoryExclusionDetails": {
    object (SensitiveCategoryAssignedTargetingOptionDetails)
  },
  "exchangeDetails": {
    object (ExchangeAssignedTargetingOptionDetails)
  },
  "subExchangeDetails": {
    object (SubExchangeAssignedTargetingOptionDetails)
  },
  "thirdPartyVerifierDetails": {
    object (ThirdPartyVerifierAssignedTargetingOptionDetails)
  },
  "poiDetails": {
    object (PoiAssignedTargetingOptionDetails)
  },
  "businessChainDetails": {
    object (BusinessChainAssignedTargetingOptionDetails)
  },
  "contentDurationDetails": {
    object (ContentDurationAssignedTargetingOptionDetails)
  },
  "contentStreamTypeDetails": {
    object (ContentStreamTypeAssignedTargetingOptionDetails)
  },
  "nativeContentPositionDetails": {
    object (NativeContentPositionAssignedTargetingOptionDetails)
  },
  "omidDetails": {
    object (OmidAssignedTargetingOptionDetails)
  },
  "audioContentTypeDetails": {
    object (AudioContentTypeAssignedTargetingOptionDetails)
  },
  "contentGenreDetails": {
    object (ContentGenreAssignedTargetingOptionDetails)
  },
  "youtubeVideoDetails": {
    object (YoutubeVideoAssignedTargetingOptionDetails)
  },
  "youtubeChannelDetails": {
    object (YoutubeChannelAssignedTargetingOptionDetails)
  },
  "sessionPositionDetails": {
    object (SessionPositionAssignedTargetingOptionDetails)
  }
  // End of list of possible types for union field details.
}
字段
name

string

仅限输出。此已分配定位选项的资源名称。
assignedTargetingOptionId

string

仅限输出。指定的定位选项的唯一 ID。此 ID 仅在给定资源和定位类型中具有唯一性。它可能会在其他上下文中重复使用。
assignedTargetingOptionIdAlias

string

仅限输出。assignedTargetingOptionId 的别名。在检索或删除现有定位条件时，此值可代替 assignedTargetingOptionId。

只有以下定位类型的所有已分配定位选项均支持此字段：

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_EXCHANGE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_NATIVE_CONTENT_POSITION
  • TARGETING_TYPE_OMID
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_VIDEO_PLAYER_SIZE
  • TARGETING_TYPE_VIEWABILITY

为订单项分配的以下定位类型定位选项也支持此字段：

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
targetingType

enum (TargetingType)

仅限输出。指明此已分配定位选项的类型。
inheritance

enum (Inheritance)

仅限输出。所分配的定位选项的沿用状态。
联合字段 details。有关所分配的定位选项的详细信息。您只能填写“details”中的一项，且该项必须与 targeting_type 对应；details 只能是以下各项之一：
channelDetails

object (ChannelAssignedTargetingOptionDetails)

渠道详情。当 targetingType 为 TARGETING_TYPE_CHANNEL 时，系统会填充此字段。
appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

应用类别详情。当 targetingType 为 TARGETING_TYPE_APP_CATEGORY 时，系统会填充此字段。
appDetails

object (AppAssignedTargetingOptionDetails)

应用详情。当 targetingType 为 TARGETING_TYPE_APP 时，系统会填充此字段。
urlDetails

object (UrlAssignedTargetingOptionDetails)

网址详情。当 targetingType 为 TARGETING_TYPE_URL 时，将填充此字段。
dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

日期和时间详情。当 targetingType 为 TARGETING_TYPE_DAY_AND_TIME 时，系统会填充此字段。
ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

年龄段详细信息。当 targetingType 为 TARGETING_TYPE_AGE_RANGE 时，将填充此字段。
regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

区域位置列表详情。当 targetingType 为 TARGETING_TYPE_REGIONAL_LOCATION_LIST 时，系统会填充此字段。
proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

邻近地理位置列表详情。当 targetingType 为 TARGETING_TYPE_PROXIMITY_LOCATION_LIST 时，将填充此字段。
genderDetails

object (GenderAssignedTargetingOptionDetails)

性别详细信息。当 targetingType 为 TARGETING_TYPE_GENDER 时，将填充此字段。
videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

视频播放器尺寸详情。当 targetingType 为 TARGETING_TYPE_VIDEO_PLAYER_SIZE 时，系统会填充此字段。
userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

会激励用户的内容详细信息。当 targetingType 为 TARGETING_TYPE_USER_REWARDED_CONTENT 时，系统会填充此字段。
parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

育儿状况详情。当 targetingType 为 TARGETING_TYPE_PARENTAL_STATUS 时，系统会填充此字段。
contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

内容插播广告位置详情。当 targetingType 为 TARGETING_TYPE_CONTENT_INSTREAM_POSITION 时，系统会填充此字段。
contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

内容外播位置详细信息。当 targetingType 为 TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION 时，将填充此字段。
deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

设备类型详细信息。当 targetingType 为 TARGETING_TYPE_DEVICE_TYPE 时，将填充此字段。
audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

受众群体定位详细信息。当 targetingType 为 TARGETING_TYPE_AUDIENCE_GROUP 时，将填充此字段。每个资源只能定位一个受众群体组选项。
browserDetails

object (BrowserAssignedTargetingOptionDetails)

浏览器详细信息。当 targetingType 为 TARGETING_TYPE_BROWSER 时，将填充此字段。
householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

家庭收入详细信息。当 targetingType 为 TARGETING_TYPE_HOUSEHOLD_INCOME 时，将填充此字段。
onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

屏幕位置详情。当 targetingType 为 TARGETING_TYPE_ON_SCREEN_POSITION 时，将填充此字段。
carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

运营商和 ISP 详细信息。当 targetingType 为 TARGETING_TYPE_CARRIER_AND_ISP 时，将填充此字段。
keywordDetails

object (KeywordAssignedTargetingOptionDetails)

关键字详情。当 targetingType 为 TARGETING_TYPE_KEYWORD 时，将填充此字段。

每项资源最多只能分配 5000 个直接否定关键字。可指定的肯定关键字的数量没有限制。
negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

关键字详情。当 targetingType 为 TARGETING_TYPE_NEGATIVE_KEYWORD_LIST 时，将填充此字段。

一个资源最多只能分配 4 个否定关键字列表。
operatingSystemDetails

object (OperatingSystemAssignedTargetingOptionDetails)

操作系统详情。当 targetingType 为 TARGETING_TYPE_OPERATING_SYSTEM 时，将填充此字段。
deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

设备品牌和型号详情。当 targetingType 为 TARGETING_TYPE_DEVICE_MAKE_MODEL 时，将填充此字段。
environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

环境详情。当 targetingType 为 TARGETING_TYPE_ENVIRONMENT 时，将填充此字段。
inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

广告资源来源详情。当 targetingType 为 TARGETING_TYPE_INVENTORY_SOURCE 时，将填充此字段。
categoryDetails

object (CategoryAssignedTargetingOptionDetails)

类别详细信息。当 targetingType 为 TARGETING_TYPE_CATEGORY 时，系统会填充此字段。

定位到某个类别即会定位到其子类别。如果您在定位条件中排除了某个类别，但包含了某个子类别，则排除条件的优先级更高。
viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

可见度详细信息。当 targetingType 为 TARGETING_TYPE_VIEWABILITY 时，将填充此字段。

每个资源只能定位一个可见度选项。
authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

授权卖方状态详情。当 targetingType 为 TARGETING_TYPE_AUTHORIZED_SELLER_STATUS 时，将填充此字段。

每项资源只能定位 1 个授权卖方状态选项。

如果资源没有“授权卖方”状态选项，则默认情况下，ads.txt 文件中指定为 DIRECT 或 RESELLER 的所有授权卖方都会成为定位目标。
languageDetails

object (LanguageAssignedTargetingOptionDetails)

语言详细信息。当 targetingType 为 TARGETING_TYPE_LANGUAGE 时，将填充此字段。
geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

地理区域详细信息。当 targetingType 为 TARGETING_TYPE_GEO_REGION 时，将填充此字段。
inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

广告资源来源组详细信息。当 targetingType 为 TARGETING_TYPE_INVENTORY_SOURCE_GROUP 时，系统会填充此字段。
digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

数字内容标签详情。当 targetingType 为 TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION 时，将填充此字段。

数字内容标签是定位排除对象。广告客户级数字内容标签排除对象（如果已设置）将始终在投放时应用（即使它们在资源设置中不可见）。除了广告客户排除对象之外，资源设置还可以排除内容标签，但无法替换它们。如果排除所有数字内容标签，订单项将不会投放。
sensitiveCategoryExclusionDetails

object (SensitiveCategoryAssignedTargetingOptionDetails)

敏感类别详情。当 targetingType 为 TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION 时，将填充此字段。

敏感类别是定位条件排除对象。广告客户级敏感类别排除项（如已设置）将始终在投放时应用（即使它们在资源设置中不可见）。资源设置除了可以排除广告客户外，还可以排除敏感类别，但无法覆盖这些类别。
exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

换货详情。当 targetingType 为 TARGETING_TYPE_EXCHANGE 时，将填充此字段。
subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

子广告交易平台详细信息。当 targetingType 为 TARGETING_TYPE_SUB_EXCHANGE 时，系统会填充此字段。
thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

第三方验证详情。当 targetingType 为 TARGETING_TYPE_THIRD_PARTY_VERIFIER 时，将填充此字段。
poiDetails

object (PoiAssignedTargetingOptionDetails)

地图注点详情。当 targetingType 为 TARGETING_TYPE_POI 时，系统会填充此字段。
businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

连锁企业详细信息。当 targetingType 为 TARGETING_TYPE_BUSINESS_CHAIN 时，将填充此字段。
contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

内容时长详情。当 targetingType 为 TARGETING_TYPE_CONTENT_DURATION 时，将填充此字段。
contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

内容时长详情。当 TargetingType 为 TARGETING_TYPE_CONTENT_STREAM_TYPE 时，将填充此字段。
nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

原生内容位置详细信息。当 targetingType 为 TARGETING_TYPE_NATIVE_CONTENT_POSITION 时，系统会填充此字段。
omidDetails

object (OmidAssignedTargetingOptionDetails)

Open Measurement 启用了广告资源详情。当 targetingType 为 TARGETING_TYPE_OMID 时，系统会填充此字段。
audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

音频内容类型详情。当 targetingType 为 TARGETING_TYPE_AUDIO_CONTENT_TYPE 时，系统会填充此字段。
contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

内容类型详细信息。当 targetingType 为 TARGETING_TYPE_CONTENT_GENRE 时，系统会填充此字段。
youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

YouTube 视频详细信息。当 targetingType 为 TARGETING_TYPE_YOUTUBE_VIDEO 时，将填充此字段。
youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

YouTube 频道详细信息。当 targetingType 为 TARGETING_TYPE_YOUTUBE_CHANNEL 时，系统会填充此字段。
sessionPositionDetails

object (SessionPositionAssignedTargetingOptionDetails)

会话位置详情。当 targetingType 为 TARGETING_TYPE_SESSION_POSITION 时，将填充此字段。

继承

指明指定的定位选项是否继承自更高级别的实体（如合作伙伴或广告客户）。继承的分配定位选项优先级更高，在投放时始终优先于当前级别分配的定位条件，并且无法通过当前实体服务进行修改。必须通过继承而来的实体服务对其进行修改。沿用仅适用于排除性定位的频道、敏感类别排除对象和数字内容标签排除对象（前提是这些排除对象是在父级配置的）。

枚举
INHERITANCE_UNSPECIFIED 继承未指定或未知。
NOT_INHERITED 指定的定位选项不是继承自更高级别的实体。
INHERITED_FROM_PARTNER 分配的定位选项会从合作伙伴定位设置继承。
INHERITED_FROM_ADVERTISER 分配的定位选项沿用自广告客户定位设置。

ChannelAssignedTargetingOptionDetails

分配的渠道定位选项的详细信息。当 targetingType 为 TARGETING_TYPE_CHANNEL 时，系统会在 AssignedTargetingOption 的 details 字段中填充此值。

JSON 表示法 
{
  "channelId": string,
  "negative": boolean
}
字段
channelId

string (int64 format)

必需。渠道的 ID。应引用合作伙伴拥有的频道或广告客户拥有的频道资源的频道 ID 字段。
negative

boolean

指明此选项是否正被否定定位条件。对于广告客户级别分配的定位选项，此字段必须为 true。

AppCategoryAssignedTargetingOptionDetails

已分配的应用类别定位选项的详细信息。当 targetingType 为 TARGETING_TYPE_APP_CATEGORY 时，系统会在 AssignedTargetingOption 的 appCategoryDetails 字段中填充此值。

JSON 表示法 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
字段
displayName

string

仅限输出。应用类别的显示名称。
targetingOptionId

string

必需。targetingType 为 TARGETING_TYPE_APP_CATEGORY 时的 targetingOptionId 字段。
negative

boolean

指明此选项是否正被否定定位条件。

AppAssignedTargetingOptionDetails

已分配的应用定位选项的详细信息。当 targetingType 为 TARGETING_TYPE_APP 时，系统会在 AssignedTargetingOption 的 details 字段中填充此值。

JSON 表示法 
{
  "appId": string,
  "displayName": string,
  "negative": boolean,
  "appPlatform": enum (AppPlatform)
}
字段
appId

string

必需。应用的 ID。

Android 的 Play 商店应用使用软件包 ID，例如 com.google.android.gm。Apple 的 App Store 应用 ID 使用 9 位数字字符串，例如 422689480。
displayName

string

仅限输出。应用的显示名称。
negative

boolean

指示是否针对此选项设置了排除对象。
appPlatform

enum (AppPlatform)

指示目标应用的平台。如果未指定此字段，系统会假定应用平台是移动平台（即Android 或 iOS），然后我们就可以通过应用 ID 获取相应的移动平台。

AppPlatform

可能的应用平台定位选项。

枚举
APP_PLATFORM_UNSPECIFIED 当此版本中未指定应用平台时的默认值。此枚举是默认值的占位符，不表示真实的平台选项。
APP_PLATFORM_IOS 应用平台为 iOS。
APP_PLATFORM_ANDROID 应用平台为 Android。
APP_PLATFORM_ROKU 应用平台为 Roku。
APP_PLATFORM_AMAZON_FIRETV 该应用平台为 Amazon FireTV。
APP_PLATFORM_PLAYSTATION 该应用平台为 Playstation。
APP_PLATFORM_APPLE_TV 应用平台为 Apple TV。
APP_PLATFORM_XBOX 应用平台为 Xbox。
APP_PLATFORM_SAMSUNG_TV 应用平台为 Samsung TV。
APP_PLATFORM_ANDROID_TV 应用平台为 Android TV。
APP_PLATFORM_GENERIC_CTV 应用平台是未在其他位置明确列出的联网电视平台。
APP_PLATFORM_LG_TV 应用平台为 LG TV。
APP_PLATFORM_VIZIO_TV 应用平台为 VIZIO TV。

UrlAssignedTargetingOptionDetails

有关已分配的网址定位选项的详细信息。当 targetingType 为 TARGETING_TYPE_URL 时，系统会在 AssignedTargetingOption 的 details 字段中填充此值。

JSON 表示法 
{
  "url": string,
  "negative": boolean
}
字段
url

string

必需。网址，例如 example.com。

DV360 支持两个级别的子目录定位（例如 www.example.com/one-subdirectory-level/second-level）和五个级别的子网域定位（例如 five.four.three.two.one.example.com）。
negative

boolean

指示是否针对此选项设置了排除对象。

DayAndTimeAssignedTargetingOptionDetails

表示在特定日期定义且具有开始时间和结束时间的时间段。startHour 表示的时间必须早于 endHour 表示的时间。

JSON 表示法 
{
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer,
  "timeZoneResolution": enum (TimeZoneResolution)
}
字段
dayOfWeek

enum (DayOfWeek)

必需。此日期和时间定位设置对应的星期几。
startHour

integer

必需。日期和时间定位的起始小时。必须介于 0（一天开始时）和 23（一天结束前 1 小时）之间。
endHour

integer

必需。日期和时间定位的结束时间。必须介于 1（一天开始后 1 小时）和 24（一天结束）之间。
timeZoneResolution

enum (TimeZoneResolution)

必需。用于确定为此日期和时间定位设置使用哪个时区的机制。

DayOfWeek

表示星期几。

枚举
DAY_OF_WEEK_UNSPECIFIED 未指定星期几。
MONDAY 星期一
TUESDAY 星期二
WEDNESDAY 星期三
THURSDAY 星期四
FRIDAY 星期五
SATURDAY 星期六
SUNDAY 星期日

TimeZoneResolution

解析时区的可能方法。

枚举
TIME_ZONE_RESOLUTION_UNSPECIFIED 时区分辨率不明确或未知。
TIME_ZONE_RESOLUTION_END_USER 时间采用看到广告的用户所在的时区。
TIME_ZONE_RESOLUTION_ADVERTISER 系统会根据投放广告的广告客户所在的时区解析时间。

AgeRangeAssignedTargetingOptionDetails

表示可定位的年龄段。当 targetingType 为 TARGETING_TYPE_AGE_RANGE 时，此值将会填充到 AssignTargetingOption 的详情字段中。

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

enum (AgeRange)

必需。受众群体的年龄段。我们仅支持定位到受众群体的连续年龄范围。因此，此字段中的年龄段可以 1) 单独定位，或 2) 属于某个较大的连续年龄段。通过同时定位年龄未知的受众群体，可以扩大连续年龄段定位的覆盖面。

RegionalLocationListAssignedTargetingOptionDetails

区域地理位置列表的定位详细信息。当 targetingType 为 TARGETING_TYPE_REGIONAL_LOCATION_LIST 时，此值将会填充到 AssignTargetingOption 的详情字段中。

JSON 表示法 
{
  "regionalLocationListId": string,
  "negative": boolean
}
字段
regionalLocationListId

string (int64 format)

必需。区域性地理位置列表的 ID。应引用类型为 TARGETING_LOCATION_TYPE_REGIONAL 的 LocationList 资源的 locationListId 字段。
negative

boolean

指示是否针对此选项设置了排除对象。

ProximityLocationListAssignedTargetingOptionDetails

相邻地理位置列表的定位条件详情。当 targetingType 为 TARGETING_TYPE_PROXIMITY_LOCATION_LIST 时，系统会在 AssignedTargetingOption 的 details 字段中填充此值。

JSON 表示法 
{
  "proximityLocationListId": string,
  "proximityRadius": number,
  "proximityRadiusUnit": enum (ProximityRadiusUnit)
}
字段
proximityLocationListId

string (int64 format)

必需。邻近区域地理位置列表的 ID。应引用类型为 TARGETING_LOCATION_TYPE_PROXIMITY 的 LocationList 资源的 locationListId 字段。
proximityRadius

number

必需。半径，以 proximityRadiusUnit 中设置的距离单位表示。这表示所选地理位置周围将定位的区域大小。半径应介于 1 到 500 英里或 800 公里之间。
proximityRadiusUnit

enum (ProximityRadiusUnit)

必需。半径距离单位。

ProximityRadiusUnit

ProximityRadius 的距离单位枚举。

枚举
PROXIMITY_RADIUS_UNIT_UNSPECIFIED 该版本未指定距离单位时的默认值。此枚举是默认值的占位符，并不表示实际的距离单位。
PROXIMITY_RADIUS_UNIT_MILES 半径距离单位为英里。
PROXIMITY_RADIUS_UNIT_KILOMETERS 半径距离单位（以公里为单位）

GenderAssignedTargetingOptionDetails

有关已分配的性别定位选项的详情。当 targetingType 为 TARGETING_TYPE_GENDER 时，此值将会填充到 AssignTargetingOption 的详情字段中。

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

enum (Gender)

必需。受众群体的性别。

VideoPlayerSizeAssignedTargetingOptionDetails

视频播放器尺寸定位选项详情。当 targetingType 为 TARGETING_TYPE_VIDEO_PLAYER_SIZE 时，将填充 videoPlayerSizeDetails 字段。不支持明确定位所有选项。要达到这种效果，请移除所有视频播放器尺寸定位选项。

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

enum (VideoPlayerSize)

必需。视频播放器的尺寸。

UserRewardedContentAssignedTargetingOptionDetails

“会激励用户的内容”定位选项详情。当 targetingType 为 TARGETING_TYPE_USER_REWARDED_CONTENT 时，将填充 userRewardedContentDetails 字段。

JSON 表示法 
{
  "targetingOptionId": string,
  "userRewardedContent": enum (UserRewardedContent)
}
字段
targetingOptionId

string

必需。当 targetingType 为 TARGETING_TYPE_USER_REWARDED_CONTENT 时，targetingOptionId 字段。
userRewardedContent

enum (UserRewardedContent)

仅限输出。视频广告的用户奖励内容状态。

ParentalStatusAssignedTargetingOptionDetails

指定的生育情况定位选项的详细信息。当 targetingType 为 TARGETING_TYPE_PARENTAL_STATUS 时，系统会在 AssignedTargetingOption 的 details 字段中填充此值。

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

enum (ParentalStatus)

必需。受众群体的育儿状况。

ContentInstreamPositionAssignedTargetingOptionDetails

已分配的内容插播位置定位选项的详细信息。当 targetingType 为 TARGETING_TYPE_CONTENT_INSTREAM_POSITION 时，将填充 contentInstreamPositionDetails 字段。

JSON 表示法 
{
  "contentInstreamPosition": enum (ContentInstreamPosition),
  "adType": enum (AdType)
}
字段
contentInstreamPosition

enum (ContentInstreamPosition)

必需。视频或音频广告的内容插播位置。
adType

enum (AdType)

仅限输出。要定位到的广告类型。仅适用于广告订单定位，并且支持指定广告类型的新订单项会默认沿用此定位选项。可能的值包括：

  • AD_TYPE_VIDEO，则当 lineItemType 为 LINE_ITEM_TYPE_VIDEO_DEFAULT 时，新订单项将继承此设置。
  • AD_TYPE_AUDIO，则当 lineItemType 为 LINE_ITEM_TYPE_AUDIO_DEFAULT 时，新订单项将继承此设置。

AdType

表示与广告相关联的广告素材类型。

枚举
AD_TYPE_UNSPECIFIED 此版本中未指定广告类型或广告类型未知。
AD_TYPE_DISPLAY 展示广告素材，例如和 HTML5。
AD_TYPE_VIDEO 视频广告素材，例如在视频播放器中流式传输内容期间播放的视频广告。
AD_TYPE_AUDIO 音频广告素材，例如在音频内容播放期间播放的音频广告。

ContentOutstreamPositionAssignedTargetingOptionDetails

分配的内容外播位置定位选项详细信息。当 targetingType 为 TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION 时，将填充 contentOutstreamPositionDetails 字段。

JSON 表示法 
{
  "contentOutstreamPosition": enum (ContentOutstreamPosition),
  "adType": enum (AdType)
}
字段
contentOutstreamPosition

enum (ContentOutstreamPosition)

必需。内容外播位置。
adType

enum (AdType)

仅限输出。要定位的广告类型。仅适用于广告订单定位，并且支持指定广告类型的新订单项会默认沿用此定位选项。可能的值包括：

  • AD_TYPE_DISPLAY，当 lineItemType 为 LINE_ITEM_TYPE_DISPLAY_DEFAULT 时，新订单项将继承此设置。
  • AD_TYPE_VIDEO，当 lineItemType 为 LINE_ITEM_TYPE_VIDEO_DEFAULT 时，新订单项将继承此设置。

DeviceTypeAssignedTargetingOptionDetails

设备类型的定位详细信息。当 targetingType 为 TARGETING_TYPE_DEVICE_TYPE 时，此值将会填充到 AssignTargetingOption 的详情字段中。

JSON 表示法 
{
  "deviceType": enum (DeviceType),
  "youtubeAndPartnersBidMultiplier": number
}
字段
deviceType

enum (DeviceType)

必需。设备类型的显示名称。
youtubeAndPartnersBidMultiplier

number

仅限输出。借助出价乘数，您可以根据设备类型提高或降低广告的展示频率。它会对原出价应用调节系数。当此字段为 0 时，表示此字段不适用，即用原始出价乘以 0。

例如，如果没有调节系数的出价金额为 10.0 元，平板电脑的调节系数为 1.5，那么针对平板电脑的最终出价就是 15.0 元。

仅适用于 YouTube 及合作伙伴订单项。

AudienceGroupAssignedTargetingOptionDetails

分配的受众群体定位选项详细信息。当 targetingType 为 TARGETING_TYPE_AUDIENCE_GROUP 时，此值将会填充到 AssignTargetingOption 的详情字段中。每个组之间的关系为 UNION，但 excludedFirstAndThirdPartyAudienceGroup 和 excludedGoogleAudienceGroup 都相同，其中 COMPLEMENT 用作与其他组的交汇点。

JSON 表示法 
{
  "includedFirstAndThirdPartyAudienceGroups": [
    {
      object (FirstAndThirdPartyAudienceGroup)
    }
  ],
  "includedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  },
  "includedCustomListGroup": {
    object (CustomListGroup)
  },
  "includedCombinedAudienceGroup": {
    object (CombinedAudienceGroup)
  },
  "excludedFirstAndThirdPartyAudienceGroup": {
    object (FirstAndThirdPartyAudienceGroup)
  },
  "excludedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  }
}
字段
includedFirstAndThirdPartyAudienceGroups[]

object (FirstAndThirdPartyAudienceGroup)

添加的第一方和第三方受众群体组的第一方和第三方受众群体 ID 和新近度。每个第一方和第三方受众群体组仅包含第一方和第三方受众群体 ID。每个第一方受众群体组和每个第三方受众群体组之间的关系均为 更加 ，结果是与其他受众群体组进行 UNION 处理。系统会忽略具有相同设置的重复群组。
includedGoogleAudienceGroup

object (GoogleAudienceGroup)

所包含 Google 受众群体组的 Google 受众群体 ID。仅包含 Google 受众群体 ID。
includedCustomListGroup

object (CustomListGroup)

所包含自定义列表组的自定义列表 ID。仅包含自定义列表 ID。
includedCombinedAudienceGroup

object (CombinedAudienceGroup)

包含的组合受众群体组的组合受众群体 ID。仅包含组合的受众群体 ID。
excludedFirstAndThirdPartyAudienceGroup

object (FirstAndThirdPartyAudienceGroup)

已排除的第一方和第三方受众群体组的第一方和第三方受众群体 ID 和新近度。用于排除性定位。此组与其他排除的受众群体组的 UNION 的补集将用作任何正例受众群体定位的 INTERSECTION。所有项之间逻辑关系为“或”。
excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

要排除的 Google 受众群体组的 Google 受众群体 ID。用于排除性定位。将此群组和其他已排除的受众群体组的“UNION”组合起来将用作任何肯定受众群体定位条件的交集。仅包含“兴趣相似的受众群体”、“有购买意向的受众群体”和“已安装应用”类型的 Google 受众群体。所有项之间逻辑关系为“或”。

FirstAndThirdPartyAudienceGroup

第一方受众群体和第三方受众群体的详细信息。所有第一方和第三方受众群体定位设置在逻辑上是“或”的关系。

JSON 表示法 
{
  "settings": [
    {
      object (FirstAndThirdPartyAudienceTargetingSetting)
    }
  ]
}
字段
settings[]

object (FirstAndThirdPartyAudienceTargetingSetting)

必需。第一方和第三方受众群体组中的所有第一方和第三方受众群体定位设置。不允许重复使用相同 ID 的设置。

FirstAndThirdPartyAudienceTargetingSetting

第一方和第三方受众群体定位设置的详细信息。

JSON 表示法 
{
  "firstAndThirdPartyAudienceId": string,
  "recency": enum (Recency)
}
字段
firstAndThirdPartyAudienceId

string (int64 format)

必需。第一方和第三方受众群体定位设置的第一方和第三方受众群体 ID。此 ID 为 firstAndThirdPartyAudienceId。
recency

enum (Recency)

第一方和第三方受众群体定位设置的新近度。仅适用于第一方受众群体，否则会被忽略。如需了解详情，请参阅 https://support.google.com/displayvideo/answer/2949947#recency。如果未指定，则系统不会使用新近度限制。

新近度

所有受支持的第一方和第三方受众群体回访频率值。

枚举
RECENCY_NO_LIMIT 没有新近性限制。
RECENCY_1_MINUTE 新近度为 1 分钟。
RECENCY_5_MINUTES 新近性为 5 分钟。
RECENCY_10_MINUTES 新近性为 10 分钟。
RECENCY_15_MINUTES 新近性为 15 分钟。
RECENCY_30_MINUTES 新近性为 30 分钟。
RECENCY_1_HOUR 新近性为 1 小时。
RECENCY_2_HOURS 新近度为 2 小时。
RECENCY_3_HOURS 新近性为 3 小时。
RECENCY_6_HOURS 新近度为 6 小时。
RECENCY_12_HOURS 新近度为 12 小时。
RECENCY_1_DAY 新近度为 1 天。
RECENCY_2_DAYS 新近度为 2 天。
RECENCY_3_DAYS 新近度为 3 天。
RECENCY_5_DAYS 新近度为 5 天。
RECENCY_7_DAYS 新近度为 7 天。
RECENCY_10_DAYS 新近度为 10 天。
RECENCY_14_DAYS 新近度为 14 天。
RECENCY_15_DAYS 新近度为 15 天。
RECENCY_21_DAYS 新近度为 21 天。
RECENCY_28_DAYS 新近度为 28 天。
RECENCY_30_DAYS 新近度为 30 天。
RECENCY_40_DAYS 新近度为 40 天。
RECENCY_45_DAYS 新近度为 45 天。
RECENCY_60_DAYS 新近度为 60 天。
RECENCY_90_DAYS 新近性为 90 天。
RECENCY_120_DAYS 新近度为 120 天。
RECENCY_180_DAYS 新近度为 180 天。
RECENCY_270_DAYS 新近度为 270 天。
RECENCY_365_DAYS 新近度为 365 天。

GoogleAudienceGroup

Google 受众群体的详细信息。所有 Google 受众群体定位设置之间都是逻辑“或”关系。

JSON 表示法 
{
  "settings": [
    {
      object (GoogleAudienceTargetingSetting)
    }
  ]
}
字段
settings[]

object (GoogleAudienceTargetingSetting)

必需。Google 受众群体群组中的所有 Google 受众群体定位设置。系统会忽略具有相同 ID 的重复设置。

GoogleAudienceTargetingSetting

Google 受众群体定位设置的详细信息。

JSON 表示法 
{
  "googleAudienceId": string
}
字段
googleAudienceId

string (int64 format)

必需。Google 受众群体定位设置对应的 Google 受众群体 ID。此 ID 为 googleAudienceId。

CustomListGroup

自定义列表组的详细信息。所有自定义名单定位设置都以“或”逻辑方式互相使用。

JSON 表示法 
{
  "settings": [
    {
      object (CustomListTargetingSetting)
    }
  ]
}
字段
settings[]

object (CustomListTargetingSetting)

必需。自定义列表组中的所有自定义列表定位设置。系统会忽略具有相同 ID 的重复设置。

CustomListTargetingSetting

自定义列表定位设置的详细信息。

JSON 表示法 
{
  "customListId": string
}
字段
customListId

string (int64 format)

必需。自定义列表定位设置的自定义 ID。此 ID 为 customListId。

CombinedAudienceGroup

组合受众群体组的详细信息。所有组合的受众群体定位设置之间都是逻辑“或”关系。

JSON 表示法 
{
  "settings": [
    {
      object (CombinedAudienceTargetingSetting)
    }
  ]
}
字段
settings[]

object (CombinedAudienceTargetingSetting)

必需。组合受众群体组中的所有组合受众群体定位设置。系统会忽略具有相同 ID 的重复设置。组合的受众群体设置的数量不得超过 5 个，否则系统将抛出错误。

CombinedAudienceTargetingSetting

组合受众群体定位设置详情。

JSON 表示法 
{
  "combinedAudienceId": string
}
字段
combinedAudienceId

string (int64 format)

必需。组合的受众群体定位设置的组合受众群体 ID。此 ID 为 combinedAudienceId。

BrowserAssignedTargetingOptionDetails

分配的浏览器定位选项的详细信息。当 targetingType 为 TARGETING_TYPE_BROWSER 时，此值将会填充到 AssignTargetingOption 的详情字段中。

JSON 表示法 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
字段
displayName

string

仅限输出。浏览器的显示名称。
targetingOptionId

string

必需。TARGETING_TYPE_BROWSER 类型的 TargetingOption 的 targetingOptionId。
negative

boolean

指示是否针对此选项设置了排除对象。对于同一资源，所有已分配的浏览器定位选项的此字段值必须相同。

HouseholdIncomeAssignedTargetingOptionDetails

已分配的家庭收入定位选项的详细信息。当 targetingType 为 TARGETING_TYPE_HOUSEHOLD_INCOME 时，此值将会填充到 AssignTargetingOption 的详情字段中。

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

enum (HouseholdIncome)

必需。受众群体的家庭收入。

OnScreenPositionAssignedTargetingOptionDetails

屏幕内位置定位选项的详细信息。当 targetingType 为 TARGETING_TYPE_ON_SCREEN_POSITION 时，将填充 onScreenPositionDetails 字段。

JSON 表示法 
{
  "targetingOptionId": string,
  "onScreenPosition": enum (OnScreenPosition),
  "adType": enum (AdType)
}
字段
targetingOptionId

string

必需。targetingType 为 TARGETING_TYPE_ON_SCREEN_POSITION 时的 targetingOptionId 字段。
onScreenPosition

enum (OnScreenPosition)

仅限输出。屏幕上的位置。
adType

enum (AdType)

仅限输出。要定位的广告类型。仅适用于广告订单定位，并且默认情况下，支持指定广告类型的新订单项将继承此定位选项。可能的值包括：

  • AD_TYPE_DISPLAY，则当 lineItemType 为 LINE_ITEM_TYPE_DISPLAY_DEFAULT 时，新订单项将继承此设置。
  • AD_TYPE_VIDEO，当 lineItemType 为 LINE_ITEM_TYPE_VIDEO_DEFAULT 时，新订单项将继承此设置。

CarrierAndIspAssignedTargetingOptionDetails

所分配的运营商和 ISP 定位选项的详细信息。当 targetingType 为 TARGETING_TYPE_CARRIER_AND_ISP 时，系统会在 AssignedTargetingOption 的 details 字段中填充此值。

JSON 表示法 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
字段
displayName

string

仅限输出。运营商或 ISP 的显示名称。
targetingOptionId

string

必需。TARGETING_TYPE_CARRIER_AND_ISP 类型的 TargetingOption 的 targetingOptionId。
negative

boolean

指明此选项是否正被否定定位条件。针对同一资源的所有已分配的运营商和 ISP 定位选项的此字段必须具有相同的值。

KeywordAssignedTargetingOptionDetails

分配的关键字定位选项的详细信息。当 targetingType 为 TARGETING_TYPE_KEYWORD 时，系统会在 AssignedTargetingOption 的 details 字段中填充此值。

JSON 表示法 
{
  "keyword": string,
  "negative": boolean
}
字段
keyword

string

必需。关键字，例如 car insurance。

肯定关键字不得有冒犯性字词。必须采用 UTF-8 编码，大小不得超过 255 字节。字符数上限为 80。字词数上限为 10。
negative

boolean

指明此选项是否正被否定定位条件。

NegativeKeywordListAssignedTargetingOptionDetails

否定关键字列表的定位详细信息。当 targetingType 为 TARGETING_TYPE_NEGATIVE_KEYWORD_LIST 时，此值将会填充到 AssignTargetingOption 的详情字段中。

JSON 表示法 
{
  "negativeKeywordListId": string
}
字段
negativeKeywordListId

string (int64 format)

必需。否定关键字列表的 ID。应引用 NegativeKeywordList 资源的 negativeKeywordListId 字段。

OperatingSystemAssignedTargetingOptionDetails

分配的操作系统定位选项详情。当 targetingType 为 TARGETING_TYPE_OPERATING_SYSTEM 时，将填充 operatingSystemDetails 字段。

JSON 表示法 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
字段
displayName

string

仅限输出。操作系统的显示名称。
targetingOptionId

string

必需。当 targetingType 为 TARGETING_TYPE_OPERATING_SYSTEM 时，targetingOptionId 字段中填充的定位选项 ID。
negative

boolean

指明此选项是否正被否定定位条件。

DeviceMakeModelAssignedTargetingOptionDetails

已分配设备品牌和型号定位选项的详细信息。当 targetingType 为 TARGETING_TYPE_DEVICE_MAKE_MODEL 时，系统会在 deviceMakeModelDetails 字段中填充此值。

JSON 表示法 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
字段
displayName

string

仅限输出。设备的品牌和型号的显示名称。
targetingOptionId

string

必需。targetingType 为 TARGETING_TYPE_DEVICE_MAKE_MODEL 时的 targetingOptionId 字段。
negative

boolean

指示是否针对此选项设置了排除对象。

EnvironmentAssignedTargetingOptionDetails

分配的环境定位选项详细信息。当 targetingType 为 TARGETING_TYPE_ENVIRONMENT 时，此值将会填充到 AssignTargetingOption 的详情字段中。

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

enum (Environment)

必需。投放环境。

InventorySourceAssignedTargetingOptionDetails

广告资源来源的定位详细信息。当 targetingType 为 TARGETING_TYPE_INVENTORY_SOURCE 时，此值将会填充到 AssignTargetingOption 的详情字段中。

JSON 表示法 
{
  "inventorySourceId": string
}
字段
inventorySourceId

string (int64 format)

必需。广告资源来源的 ID。应引用 InventorySource 资源的 inventorySourceId 字段。

CategoryAssignedTargetingOptionDetails

分配的类别定位选项详情。当 targetingType 为 TARGETING_TYPE_CATEGORY 时，将填充 categoryDetails 字段。

JSON 表示法 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
字段
displayName

string

仅限输出。类别的显示名称。
targetingOptionId

string

必需。targetingType 为 TARGETING_TYPE_CATEGORY 时的 targetingOptionId 字段。
negative

boolean

指明此选项是否正被否定定位条件。

ViewabilityAssignedTargetingOptionDetails

分配的可见度定位选项详情。当 targetingType 为 TARGETING_TYPE_VIEWABILITY 时，系统会在 AssignTargetingOption 的 viewabilityDetails 字段中填充此字段。

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

enum (Viewability)

必需。预计的可见度百分比。

AuthorizedSellerStatusAssignedTargetingOptionDetails

表示指定的授权卖方状态。当 targetingType 为 TARGETING_TYPE_AUTHORIZED_SELLER_STATUS 时，此值将会填充到 AssignTargetingOption 的详情字段中。

如果资源未分配 TARGETING_TYPE_AUTHORIZED_SELLER_STATUS 定位选项，则表示其使用的是“授权直销商和转销商”选项。

JSON 表示法 
{
  "authorizedSellerStatus": enum (AuthorizedSellerStatus),
  "targetingOptionId": string
}
字段
authorizedSellerStatus

enum (AuthorizedSellerStatus)

仅限输出。要定位到的授权卖方状态。
targetingOptionId

string

必需。类型为 TARGETING_TYPE_AUTHORIZED_SELLER_STATUS 的 TargetingOption 的 targetingOptionId。

LanguageAssignedTargetingOptionDetails

指定语言定位选项的详细信息。当 targetingType 为 TARGETING_TYPE_LANGUAGE 时，此值将会填充到 AssignTargetingOption 的详情字段中。

JSON 表示法 
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
字段
displayName

string

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

string

必需。TARGETING_TYPE_LANGUAGE 类型的 TargetingOption 的 targetingOptionId。
negative

boolean

指示是否针对此选项设置了排除对象。对于同一资源，所有已分配的语言定位选项的此字段值必须相同。

GeoRegionAssignedTargetingOptionDetails

分配的地理区域定位选项的详细信息。当 targetingType 为 TARGETING_TYPE_GEO_REGION 时，系统会在 AssignedTargetingOption 的 details 字段中填充此值。

JSON 表示法 
{
  "displayName": string,
  "targetingOptionId": string,
  "geoRegionType": enum (GeoRegionType),
  "negative": boolean
}
字段
displayName

string

仅限输出。地理区域的显示名称（例如，“安大略省，加拿大”）。
targetingOptionId

string

必需。TARGETING_TYPE_GEO_REGION 类型的 TargetingOption 的 targetingOptionId。
geoRegionType

enum (GeoRegionType)

仅限输出。地理区域定位的类型。
negative

boolean

指示是否针对此选项设置了排除对象。

InventorySourceGroupAssignedTargetingOptionDetails

广告资源来源组的定位详情。当 targetingType 为 TARGETING_TYPE_INVENTORY_SOURCE_GROUP 时，此值将会填充到 AssignTargetingOption 的详情字段中。

JSON 表示法 
{
  "inventorySourceGroupId": string
}
字段
inventorySourceGroupId

string (int64 format)

必需。广告资源来源组的 ID。应引用 InventorySourceGroup 资源的 inventorySourceGroupId 字段。

DigitalContentLabelAssignedTargetingOptionDetails

数字内容标签的定位详情。当 targetingType 为 TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION 时，此值将会填充到 AssignTargetingOption 的详情字段中。

JSON 表示法 
{
  "excludedContentRatingTier": enum (ContentRatingTier)
}
字段
excludedContentRatingTier

enum (ContentRatingTier)

必需。要排除的数字内容标签分级层级的显示名称。

SensitiveCategoryAssignedTargetingOptionDetails

敏感类别的定位详细信息。当 targetingType 为 TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION 时，此值将会填充到 AssignTargetingOption 的详情字段中。

JSON 表示法 
{
  "excludedSensitiveCategory": enum (SensitiveCategory)
}
字段
excludedSensitiveCategory

enum (SensitiveCategory)

必需。归类为排除的 DV360 敏感类别内容的枚举。

ExchangeAssignedTargetingOptionDetails

已分配的广告交易平台定位选项的详细信息。当 targetingType 为 TARGETING_TYPE_EXCHANGE 时，系统会在 AssignedTargetingOption 的 details 字段中填充此值。

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

enum (Exchange)

必需。广告交易平台的枚举值。

SubExchangeAssignedTargetingOptionDetails

已分配的子广告交易平台定位选项的详细信息。当 targetingType 为 TARGETING_TYPE_SUB_EXCHANGE 时，系统会在 AssignedTargetingOption 的 details 字段中填充此值。

JSON 表示法 
{
  "targetingOptionId": string
}
字段
targetingOptionId

string

必需。类型为 TARGETING_TYPE_SUB_EXCHANGE 的 TargetingOption 的 targetingOptionId。

ThirdPartyVerifierAssignedTargetingOptionDetails

已分配的第三方验证程序定位选项详细信息。当 targetingType 为 TARGETING_TYPE_THIRD_PARTY_VERIFIER 时，系统会在 AssignedTargetingOption 的 details 字段中填充此值。

JSON 表示法 
{

  // Union field verifier can be only one of the following:
  "adloox": {
    object (Adloox)
  },
  "doubleVerify": {
    object (DoubleVerify)
  },
  "integralAdScience": {
    object (IntegralAdScience)
  }
  // End of list of possible types for union field verifier.
}
字段
联合字段 verifier。可以定位到某个第三方验证程序，对展示强制执行品牌保障阈值。verifier 只能是下列其中一项：
adloox

object (Adloox)

第三方品牌验证机构 - Adloox。
doubleVerify

object (DoubleVerify)

第三方品牌验证机构 - DoubleVerify。
integralAdScience

object (IntegralAdScience)

第三方品牌验证商 -- Integral Ad Science。

Adloox

Adloox 设置详情。

JSON 表示法 
{
  "excludedAdlooxCategories": [
    enum (AdlooxCategory)
  ]
}
字段
excludedAdlooxCategories[]

enum (AdlooxCategory)

Adloox 的品牌保障设置。

AdlooxCategory

可能的 Adloox 选项。

枚举
ADLOOX_UNSPECIFIED 此枚举只是一个占位符，不会指定任何 Adloox 选项。
ADULT_CONTENT_HARD 成人内容（重口味）。
ADULT_CONTENT_SOFT 成人内容（软色情）。
ILLEGAL_CONTENT 非法内容。
BORDERLINE_CONTENT 擦边球内容。
DISCRIMINATORY_CONTENT 歧视性内容。
VIOLENT_CONTENT_WEAPONS 暴力内容和武器。
LOW_VIEWABILITY_DOMAINS 可见度较低的网域。
FRAUD 欺诈。

DoubleVerify

DoubleVerify 设置的详细信息。

JSON 表示法 
{
  "brandSafetyCategories": {
    object (BrandSafetyCategories)
  },
  "avoidedAgeRatings": [
    enum (AgeRating)
  ],
  "appStarRating": {
    object (AppStarRating)
  },
  "displayViewability": {
    object (DisplayViewability)
  },
  "videoViewability": {
    object (VideoViewability)
  },
  "fraudInvalidTraffic": {
    object (FraudInvalidTraffic)
  },
  "customSegmentId": string
}
字段
brandSafetyCategories

object (BrandSafetyCategories)

DV 品牌保障控制。
avoidedAgeRatings[]

enum (AgeRating)

避免对具有年龄分级的应用出价。
appStarRating

object (AppStarRating)

避免对具有星级评分的应用出价。
displayViewability

object (DisplayViewability)

展示广告可见度设置（仅适用于展示广告订单项）。
videoViewability

object (VideoViewability)

视频可见度设置（仅适用于视频订单项）。
fraudInvalidTraffic

object (FraudInvalidTraffic)

避开历史有欺诈性和无效流量比率。
customSegmentId

string (int64 format)

DoubleVerify 提供的自定义细分 ID。此 ID 必须以“51”开头，且包含 8 位数字。无法同时指定自定义细分 ID 和以下任一字段：

BrandSafetyCategories

品牌保障控制设置。

JSON 表示法 
{
  "avoidUnknownBrandSafetyCategory": boolean,
  "avoidedHighSeverityCategories": [
    enum (HighSeverityCategory)
  ],
  "avoidedMediumSeverityCategories": [
    enum (MediumSeverityCategory)
  ]
}
字段
avoidUnknownBrandSafetyCategory

boolean

未知或无法分级。
avoidedHighSeverityCategories[]

enum (HighSeverityCategory)

品牌保障高严重程度规避类别。
avoidedMediumSeverityCategories[]

enum (MediumSeverityCategory)

品牌保障中等严重程度规避类别。

HighSeverityCategory

高严重级别类别的可能选项。

枚举
HIGHER_SEVERITY_UNSPECIFIED 此枚举只是一个占位符，未指定任何高严重性类别。
ADULT_CONTENT_PORNOGRAPHY 成人内容：色情、少儿不宜主题和裸露内容。
COPYRIGHT_INFRINGEMENT 侵犯版权。
SUBSTANCE_ABUSE 药物/酒精/管制物品：药物滥用。
GRAPHIC_VIOLENCE_WEAPONS 极端图片/露骨暴力/武器。
HATE_PROFANITY 仇恨/亵渎性内容。
CRIMINAL_SKILLS 非法活动：犯罪手段。
NUISANCE_INCENTIVIZED_MALWARE_CLUTTER 利诱性内容/恶意软件/间谍软件。

MediumSeverityCategory

中等严重程度类别的可能选项。

枚举
MEDIUM_SEVERITY_UNSPECIFIED 此枚举只是一个占位符，未指定任何中等严重级别类别。
AD_SERVERS 广告服务器。
ADULT_CONTENT_SWIMSUIT 成人内容：泳衣。
ALTERNATIVE_LIFESTYLES 有争议的主题：另类生活方式。
CELEBRITY_GOSSIP 有争议的主题：名人八卦。
GAMBLING 有争议的主题：赌博。
OCCULT 有争议的主题：灵异。
SEX_EDUCATION 有争议的主题：性教育。
DISASTER_AVIATION 灾难：航空。
DISASTER_MAN_MADE 灾难：人为灾害。
DISASTER_NATURAL 灾难：自然灾害。
DISASTER_TERRORIST_EVENTS 灾难：恐怖事件。
DISASTER_VEHICLE 灾难：车辆。
ALCOHOL 毒品/酒精饮料/管制物品：酒精。
SMOKING 毒品/酒精饮料/管制物质：吸烟。
NEGATIVE_NEWS_FINANCIAL 负面新闻：金融。
NON_ENGLISH 非标准内容：非英语内容。
PARKING_PAGE 非标准内容：停车页。
UNMODERATED_UGC 未加管制的用户原创内容：论坛、图片和视频。
INFLAMMATORY_POLITICS_AND_NEWS 有争议的主题：煽动性政治和新闻。
NEGATIVE_NEWS_PHARMACEUTICAL 负面新闻：医药。

AgeRating

年龄分级的可能选项。

枚举
AGE_RATING_UNSPECIFIED 此枚举只是占位符，未指定任何年龄分级选项。
APP_AGE_RATE_UNKNOWN 年龄分级不明的应用。
APP_AGE_RATE_4_PLUS 分级为“适合所有人”（4 周岁及以上）的应用。
APP_AGE_RATE_9_PLUS 适合所有人（9 岁以上）的应用。
APP_AGE_RATE_12_PLUS 分级为“青少年”（12 周岁及以上）的应用。
APP_AGE_RATE_17_PLUS 分级为“成人”（适合年满 17 周岁）的应用。
APP_AGE_RATE_18_PLUS 仅限成人（18 岁以上）使用的应用。

AppStarRating

DoubleVerify 星级设置详情。

JSON 表示法 
{
  "avoidedStarRating": enum (StarRating),
  "avoidInsufficientStarRating": boolean
}
字段
avoidedStarRating

enum (StarRating)

避免对包含星级的应用出价。
avoidInsufficientStarRating

boolean

避免对星级评分不足的应用出价。

StarRating

可能的星级选项。

枚举
APP_STAR_RATE_UNSPECIFIED 此枚举只是一个占位符，不指定任何应用星级选项。
APP_STAR_RATE_1_POINT_5_LESS 分级为 < 的官方应用1.5 星。
APP_STAR_RATE_2_LESS 评分低于 2 星的官方应用。
APP_STAR_RATE_2_POINT_5_LESS 评分低于 2.5 星的官方应用。
APP_STAR_RATE_3_LESS 评分低于 3 星的官方应用。
APP_STAR_RATE_3_POINT_5_LESS 评分低于 3.5 星的官方应用。
APP_STAR_RATE_4_LESS 评分低于 4 星的官方应用。
APP_STAR_RATE_4_POINT_5_LESS 分级为 < 的官方应用4.5 星。

DisplayViewability

DoubleVerify 展示可见度设置的详细信息。

JSON 表示法 
{
  "iab": enum (IAB),
  "viewableDuring": enum (ViewableDuring)
}
字段
iab

enum (IAB)

定位到网站和应用内广告资源可最大限度提高 IAB 可见率。
viewableDuring

enum (ViewableDuring)

定位到网站和应用内广告资源，以最大限度地延长 100% 可见时长。

IAB

IAB 可见率的可能选项。

枚举
IAB_VIEWED_RATE_UNSPECIFIED 此枚举只是一个占位符，它未指定任何 IAB 观看率选项。
IAB_VIEWED_RATE_80_PERCENT_HIGHER 定位到网站和应用内广告资源可最大限度提高 IAB 可见率 (80%) 或更高。
IAB_VIEWED_RATE_75_PERCENT_HIGHER 定位到网站和应用内广告资源可使 IAB 可见率达到 75% 或更高。
IAB_VIEWED_RATE_70_PERCENT_HIGHER 定位到网站和应用内广告资源，以最大限度地将 IAB 可见率提升至 70% 或更高。
IAB_VIEWED_RATE_65_PERCENT_HIGHER 定位到网站和应用内广告资源，以最大限度地将 IAB 可见率提高到 65% 或更高。
IAB_VIEWED_RATE_60_PERCENT_HIGHER 定位到网站和应用内广告资源可使 IAB 可见率达到 60% 或以上。
IAB_VIEWED_RATE_55_PERCENT_HIGHER 定位到网站和应用内广告资源可使 IAB 可见率达到 55% 或更高。
IAB_VIEWED_RATE_50_PERCENT_HIGHER 定位到网站和应用内广告资源可使 IAB 可见率达到 50% 或更高。
IAB_VIEWED_RATE_40_PERCENT_HIGHER 定位到网站和应用内广告资源可使 IAB 可见率达到 40% 或更高。
IAB_VIEWED_RATE_30_PERCENT_HIGHER 定位到网站和应用内广告资源可使 IAB 可见率达到或超过 30%。

ViewableDuring

可观看时长的可能选项。

枚举
AVERAGE_VIEW_DURATION_UNSPECIFIED 此枚举只是一个占位符，未指定任何平均观看时长选项。
AVERAGE_VIEW_DURATION_5_SEC 定位到网站和应用内广告资源，将 100% 可见时长上限设为 5 秒或更长时间。
AVERAGE_VIEW_DURATION_10_SEC 定位到网站和应用内广告资源，以最大限度地延长 10 秒或更长时间的 100% 可见时长。
AVERAGE_VIEW_DURATION_15_SEC 定位到网站和应用内广告资源，将 100% 的可见时长上限设为 15 秒或更长时间。

VideoViewability

DoubleVerify 视频广告可见度设置的详细信息。

JSON 表示法 
{
  "videoIab": enum (VideoIAB),
  "videoViewableRate": enum (VideoViewableRate),
  "playerImpressionRate": enum (PlayerImpressionRate)
}
字段
videoIab

enum (VideoIAB)

定位到网站广告资源，以最大限度地提升 IAB 可见率。
videoViewableRate

enum (VideoViewableRate)

定位到网站广告资源可最大限度地提高完全可见率。
playerImpressionRate

enum (PlayerImpressionRate)

定位到播放器尺寸至少为 400x300 的广告资源，以尽可能争取更多展示。

VideoIAB

IAB 可见率的可能选项。

枚举
VIDEO_IAB_UNSPECIFIED 此枚举只是一个占位符，不会指定任何视频 IAB 可见率选项。
IAB_VIEWABILITY_80_PERCENT_HIGHER 定位到网站和应用内广告资源可最大限度提高 IAB 可见率 (80%) 或更高。
IAB_VIEWABILITY_75_PERCENT_HIGHER 定位到网站和应用内广告资源可使 IAB 可见率达到 75% 或更高。
IAB_VIEWABILITY_70_PERCENT_HIGHER 定位到网站和应用内广告资源，以最大限度地将 IAB 可见率提升至 70% 或更高。
IAB_VIEWABILITY_65_PERCENT_HIHGER 定位到网站和应用内广告资源，以最大限度地将 IAB 可见率提高到 65% 或更高。
IAB_VIEWABILITY_60_PERCENT_HIGHER 定位到网站和应用内广告资源可使 IAB 可见率达到 60% 或以上。
IAB_VIEWABILITY_55_PERCENT_HIHGER 定位到网站和应用内广告资源可使 IAB 可见率达到 55% 或更高。
IAB_VIEWABILITY_50_PERCENT_HIGHER 定位到网站和应用内广告资源可使 IAB 可见率达到 50% 或更高。
IAB_VIEWABILITY_40_PERCENT_HIHGER 定位到网站和应用内广告资源可使 IAB 可见率达到 40% 或更高。
IAB_VIEWABILITY_30_PERCENT_HIHGER 定位到网站和应用内广告资源可使 IAB 可见率达到或超过 30%。

VideoViewableRate

“全可见率”的可能选项。

枚举
VIDEO_VIEWABLE_RATE_UNSPECIFIED 此枚举只是一个占位符，它未指定任何视频可见率选项。
VIEWED_PERFORMANCE_40_PERCENT_HIGHER 定位到网站广告资源，以最大限度地提高完全可见率（40% 或更高）。
VIEWED_PERFORMANCE_35_PERCENT_HIGHER 定位到网站广告资源可最大限度提高 35% 或更高的完全可见率。
VIEWED_PERFORMANCE_30_PERCENT_HIGHER 定位到网站广告资源可最大限度提高 30% 或更高的完全可见率。
VIEWED_PERFORMANCE_25_PERCENT_HIGHER 定位到网站广告资源可最大限度提高 25% 或更高的完全可见率。
VIEWED_PERFORMANCE_20_PERCENT_HIGHER 定位到网站广告资源可最大限度提高 20% 或更高的完全可见率。
VIEWED_PERFORMANCE_10_PERCENT_HIGHER 定位到网站广告资源，以最大限度地提高完全可见率（达到 10% 或更高）。

PlayerImpressionRate

可能的展示次数选项。

枚举
PLAYER_SIZE_400X300_UNSPECIFIED 此枚举只是一个占位符，它未指定任何展示选项。
PLAYER_SIZE_400X300_95 展示次数超过 95%的网站。
PLAYER_SIZE_400X300_70 能投放 70%+ 的展示次数的网站。
PLAYER_SIZE_400X300_25 能投放 25%+ 的展示次数的网站。
PLAYER_SIZE_400X300_5 能投放 5%以上的网站。

FraudInvalidTraffic

DoubleVerify 欺诈性流量和无效流量设置。

JSON 表示法 
{
  "avoidedFraudOption": enum (FraudOption),
  "avoidInsufficientOption": boolean
}
字段
avoidedFraudOption

enum (FraudOption)

避免定位到存在历史欺诈性流量和无效流量的网站和应用。
avoidInsufficientOption

boolean

欺诈性流量和无效流量历史统计数据不足。

FraudOption

针对既往欺诈和IVT 率。

枚举
FRAUD_UNSPECIFIED 此枚举只是一个占位符，不指定任何欺诈和无效流量选项。
AD_IMPRESSION_FRAUD_100 100% 欺诈和无效流量。
AD_IMPRESSION_FRAUD_50 欺诈性及无效流量比率为 50% 或更高。
AD_IMPRESSION_FRAUD_25 欺诈性及无效流量比率为 25% 或更高。
AD_IMPRESSION_FRAUD_10 欺诈性及无效流量比率为 10% 或更高。
AD_IMPRESSION_FRAUD_8 欺诈和无效流量。
AD_IMPRESSION_FRAUD_6 欺诈和无效流量。
AD_IMPRESSION_FRAUD_4 欺诈和无效流量。
AD_IMPRESSION_FRAUD_2 欺诈和无效流量。

IntegralAdScience

Integral Ad Science 设置的详细信息。

JSON 表示法 
{
  "traqScoreOption": enum (TRAQScore),
  "excludeUnrateable": boolean,
  "excludedAdultRisk": enum (Adult),
  "excludedAlcoholRisk": enum (Alcohol),
  "excludedIllegalDownloadsRisk": enum (IllegalDownloads),
  "excludedDrugsRisk": enum (Drugs),
  "excludedHateSpeechRisk": enum (HateSpeech),
  "excludedOffensiveLanguageRisk": enum (OffensiveLanguage),
  "excludedViolenceRisk": enum (Violence),
  "excludedGamblingRisk": enum (Gambling),
  "excludedAdFraudRisk": enum (AdFraudPrevention),
  "displayViewability": enum (DisplayViewability),
  "videoViewability": enum (VideoViewability),
  "customSegmentId": [
    string
  ]
}
字段
traqScoreOption

enum (TRAQScore)

真正的广告质量（仅适用于展示广告订单项）。
excludeUnrateable

boolean

品牌保障 - 无法分级。
excludedAdultRisk

enum (Adult)

品牌保障 - 成人内容。
excludedAlcoholRisk

enum (Alcohol)

品牌保障 - 酒精。
excludedIllegalDownloadsRisk

enum (IllegalDownloads)

品牌保障 - 非法下载内容。
excludedDrugsRisk

enum (Drugs)

品牌保障 - 药品。
excludedHateSpeechRisk

enum (HateSpeech)

品牌保障 - 仇恨言论。
excludedOffensiveLanguageRisk

enum (OffensiveLanguage)

品牌保障 - 冒犯性语言。
excludedViolenceRisk

enum (Violence)

品牌保障 - 暴力内容。
excludedGamblingRisk

enum (Gambling)

品牌保障 - 赌博。
excludedAdFraudRisk

enum (AdFraudPrevention)

广告欺诈设置。
displayViewability

enum (DisplayViewability)

“展示广告可见度”部分（仅适用于展示广告订单项）。
videoViewability

enum (VideoViewability)

“视频可见度”部分（仅适用于视频广告订单项）。
customSegmentId[]

string (int64 format)

由 Integral Ad Science 提供的自定义细分 ID。ID 必须介于 1000001 和 1999999 之间（包括这两个数值）。

TRAQScore

可能的 Integral Ad Science TRAQ（真实广告质量）得分范围。

枚举
TRAQ_UNSPECIFIED 此枚举只是一个占位符，并未指定任何真实的广告质量得分。
TRAQ_250 TRAQ 得分为 250-1000。
TRAQ_500 TRAQ 得分为 500-1000。
TRAQ_600 TRAQ 得分为 600-1000。
TRAQ_700 TRAQ 得分为 700-1000。
TRAQ_750 TRAQ 得分为 750-1000。
TRAQ_875 TRAQ 得分为 875-1000。
TRAQ_1000 TRAQ 得分为 1000。

成人

可能的 Integral Ad Science 成人广告选项。

枚举
ADULT_UNSPECIFIED 此枚举只是占位符，未指定任何成人选项。
ADULT_HR 成人 - 排除高风险。
ADULT_HMR 成人 - 排除高风险和中等风险。

酒精饮料

可能的 Integral Ad Science 酒精饮料选项。

枚举
ALCOHOL_UNSPECIFIED 此枚举只是一个占位符，不指定任何酒精饮料选项。
ALCOHOL_HR 酒精 - 排除高风险。
ALCOHOL_HMR 酒精饮料 - 排除高风险和中等风险。

IllegalDownloads

可能的 Integral Ad Science 非法下载选项。

枚举
ILLEGAL_DOWNLOADS_UNSPECIFIED 此枚举只是一个占位符，它不指定任何非法的下载选项。
ILLEGAL_DOWNLOADS_HR 非法下载 - 排除高风险。
ILLEGAL_DOWNLOADS_HMR 非法下载内容 - 排除高风险和中风险。

药品

可能的 Integral Ad Science Drugs 选项。

枚举
DRUGS_UNSPECIFIED 此枚举只是一个占位符，未指定任何药品选项。
DRUGS_HR 药品 - 排除高风险。
DRUGS_HMR 药品 - 排除高风险和中风险。

HateSpeech

可能的 Integral Ad Science 仇恨言论选项。

枚举
HATE_SPEECH_UNSPECIFIED 此枚举只是一个占位符，未指定任何仇恨言论选项。
HATE_SPEECH_HR 仇恨言论 - 排除高风险。
HATE_SPEECH_HMR 仇恨言论 - 排除高风险和中风险。

OffensiveLanguage

可能的 Integral Ad Science 令人反感的语言选项。

枚举
OFFENSIVE_LANGUAGE_UNSPECIFIED 此枚举只是占位符，未指定任何语言选项。
OFFENSIVE_LANGUAGE_HR 攻击性语言 - 排除高风险。
OFFENSIVE_LANGUAGE_HMR 冒犯性语言 - 排除高风险和中风险。

暴力内容

可能的 Integral Ad Science Violence 选项。

枚举
VIOLENCE_UNSPECIFIED 此枚举只是占位符，未指定任何暴力内容选项。
VIOLENCE_HR 暴力 - 排除高风险。
VIOLENCE_HMR 暴力 - 排除高风险和中等风险。

赌博

可能的 Integral Ad Science 赌博广告选项。

枚举
GAMBLING_UNSPECIFIED 此枚举只是一个占位符，它不指定任何赌博选项。
GAMBLING_HR 赌博 - 排除高风险。
GAMBLING_HMR 赌博 - 排除高风险和中等风险。

AdFraudPrevention

可能的 Integral Ad Science 广告欺诈防范选项。

枚举
SUSPICIOUS_ACTIVITY_UNSPECIFIED 此枚举只是一个占位符，未指定任何广告欺诈防范选项。
SUSPICIOUS_ACTIVITY_HR 广告欺诈 - 排除高风险。
SUSPICIOUS_ACTIVITY_HMR 广告欺诈 - 排除高风险和中等风险。

DisplayViewability

可能的 Integral Ad Science 展示广告可见度选项。

枚举
PERFORMANCE_VIEWABILITY_UNSPECIFIED 此枚举只是一个占位符，不指定任何展示广告可见度选项。
PERFORMANCE_VIEWABILITY_40 以 40% 或更高的可见度为目标值。
PERFORMANCE_VIEWABILITY_50 以 50% 或更高的可见度为目标。
PERFORMANCE_VIEWABILITY_60 指定不低于 60% 的可见度。
PERFORMANCE_VIEWABILITY_70 指定不低于 70% 的可见度。

VideoViewability

可能的 Integral Ad Science 视频可见度选项。

枚举
VIDEO_VIEWABILITY_UNSPECIFIED 此枚举只是一个占位符，未指定任何视频可见度选项。
VIDEO_VIEWABILITY_40 40%+ 被观看（IAB 视频可见度标准）。
VIDEO_VIEWABILITY_50 50%+ 被观看（IAB 视频可见度标准）。
VIDEO_VIEWABILITY_60 60%+ 被观看（IAB 视频可见度标准）。
VIDEO_VIEWABILITY_70 70% 以上的可见度（IAB 视频可见度标准）。

PoiAssignedTargetingOptionDetails

分配的地图注点定位选项的详细信息。当 targetingType 为 TARGETING_TYPE_POI 时，此值将会填充到 AssignTargetingOption 的详情字段中。

JSON 表示法 
{
  "displayName": string,
  "targetingOptionId": string,
  "latitude": number,
  "longitude": number,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
字段
displayName

string

仅限输出。地图注点的显示名称，例如“时代广场”、“太空针塔”，以及完整的地址（如果有）。
targetingOptionId

string

必需。类型为 TARGETING_TYPE_POI 的 TargetingOption 的 targetingOptionId。

您可以使用 targetingTypes.targetingOptions.search 检索接受的地图注点定位选项 ID。

如果要定位从地址或地图注点名称中移除的特定纬度/经度坐标，您可以通过将所需坐标值四舍五入到小数点后第 6 位，移除小数，然后将字符串值串联起来（以英文分号分隔）来生成必要的定位选项 ID。例如，您可以使用定位选项 ID“40741469;-74003387”定位到纬度/经度对 40.7414691, -74.003387。创建时，如果仅提供了纬度/经度坐标，此字段值将更新为附加英文句号和字母数字哈希值。
latitude

number

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

number

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

number

必需。要定位的地图注点周围区域的半径。半径的单位由 proximityRadiusUnit 指定。如果单位为 DISTANCE_UNIT_KILOMETERS，则必须为 1 到 800；如果单位为 DISTANCE_UNIT_MILES，则必须为 1 到 500。
proximityRadiusUnit

enum (DistanceUnit)

必需。定位半径的测量距离单位。

DistanceUnit

可能的距离单位选项。

枚举
DISTANCE_UNIT_UNSPECIFIED 此版本中未指定类型值或类型值未知。
DISTANCE_UNIT_MILES 英里。
DISTANCE_UNIT_KILOMETERS 公里。

BusinessChainAssignedTargetingOptionDetails

分配的“连锁企业”定位选项的详细信息。当 targetingType 为 TARGETING_TYPE_BUSINESS_CHAIN 时，系统会在 AssignedTargetingOption 的 details 字段中填充此值。

JSON 表示法 
{
  "displayName": string,
  "targetingOptionId": string,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
字段
displayName

string

仅限输出。连锁企业的显示名称，例如“KFC”、“Chase Bank”。
targetingOptionId

string

必需。TARGETING_TYPE_BUSINESS_CHAIN 类型的 TargetingOption 的 targetingOptionId。

您可以使用 SearchTargetingOptions 检索已接受的连锁企业定位选项 ID。
proximityRadiusAmount

number

必需。将要定位的连锁企业周围区域的半径。半径的单位由 proximityRadiusUnit 指定。如果单位为 DISTANCE_UNIT_KILOMETERS，则必须为 1 到 800；如果单位为 DISTANCE_UNIT_MILES，则必须为 1 到 500。两种情况下的最小增量均为 0.1。如果输入内容过于精细，将四舍五入为最接近的可接受值，例如15.57 将变为 15.6。
proximityRadiusUnit

enum (DistanceUnit)

必需。定位半径的测量距离单位。

ContentDurationAssignedTargetingOptionDetails

指定了内容时长的定位选项的详细信息。当 targetingType 为 TARGETING_TYPE_CONTENT_DURATION 时，将填充 contentDurationDetails 字段。不支持明确定位到所有选项。移除所有内容时长定位选项可达到此效果。

JSON 表示法 
{
  "targetingOptionId": string,
  "contentDuration": enum (ContentDuration)
}
字段
targetingOptionId

string

必需。targetingType 为 TARGETING_TYPE_CONTENT_DURATION 时的 targetingOptionId 字段。
contentDuration

enum (ContentDuration)

仅限输出。内容时长。

ContentStreamTypeAssignedTargetingOptionDetails

为内容流类型分配的定位选项的详细信息。当 targetingType 为 TARGETING_TYPE_CONTENT_STREAM_TYPE 时，系统会在 contentStreamTypeDetails 字段中填充此值。不支持明确定位所有选项。移除所有内容串流类型定位选项，以实现此效果。

JSON 表示法 
{
  "targetingOptionId": string,
  "contentStreamType": enum (ContentStreamType)
}
字段
targetingOptionId

string

必需。当 targetingType 为 TARGETING_TYPE_CONTENT_STREAM_TYPE 时，targetingOptionId 字段。
contentStreamType

enum (ContentStreamType)

仅限输出。内容流类型。

NativeContentPositionAssignedTargetingOptionDetails

有关“分配给原生内容的位置”定位选项的详细信息。当 targetingType 为 TARGETING_TYPE_NATIVE_CONTENT_POSITION 时，系统会在 nativeContentPositionDetails 字段中填充此值。不支持明确定位所有选项。移除所有原生内容位置定位选项即可实现此效果。

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

enum (NativeContentPosition)

必需。内容位置。

OmidAssignedTargetingOptionDetails

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

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

enum (Omid)

必需。已启用 Open Measurement 的广告资源的类型。

AudioContentTypeAssignedTargetingOptionDetails

分配给音频内容类型的定位选项的详细信息。当 targetingType 为 TARGETING_TYPE_AUDIO_CONTENT_TYPE 时，系统会在 audioContentTypeDetails 字段中填充此值。不支持明确定位到所有选项。如需实现此效果，请移除所有音频内容类型定位选项。

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

enum (AudioContentType)

必需。音频内容类型。

ContentGenreAssignedTargetingOptionDetails

分配内容类型的定位选项的详细信息。当 targetingType 为 TARGETING_TYPE_CONTENT_GENRE 时，系统会在 contentGenreDetails 字段中填充此值。不支持明确定位到所有选项。要达到这种效果，请移除所有内容类型定位选项。

JSON 表示法 
{
  "targetingOptionId": string,
  "displayName": string,
  "negative": boolean
}
字段
targetingOptionId

string

必需。targetingType 为 TARGETING_TYPE_CONTENT_GENRE 时的 targetingOptionId 字段。
displayName

string

仅限输出。内容类型的显示名称。
negative

boolean

指示是否针对此选项设置了排除对象。

YoutubeVideoAssignedTargetingOptionDetails

分配给 YouTube 视频的定位选项的详细信息。当 targetingType 为 TARGETING_TYPE_YOUTUBE_VIDEO 时，系统会在 youtubeVideoDetails 字段中填充此值。

JSON 表示法 
{
  "videoId": string,
  "negative": boolean
}
字段
videoId

string

YouTube 观看页面上显示的 YouTube 视频 ID。
negative

boolean

指示是否针对此选项设置了排除对象。

YoutubeChannelAssignedTargetingOptionDetails

有关为 YouTube 频道分配的定位选项的详细信息。当 targetingType 为 TARGETING_TYPE_YOUTUBE_CHANNEL 时，系统会在 youtubeChannelDetails 字段中填充此值。

JSON 表示法 
{
  "channelId": string,
  "negative": boolean
}
字段
channelId

string

YouTube 上传者频道 ID 或 YouTube 频道的频道代码。
negative

boolean

指示是否针对此选项设置了排除对象。

SessionPositionAssignedTargetingOptionDetails

会话位置分配定位选项的详细信息。当 targetingType 为 TARGETING_TYPE_SESSION_POSITION 时，系统会在 sessionPositionDetails 字段中填充此值。

JSON 表示法 
{
  "sessionPosition": enum (SessionPosition)
}
字段
sessionPosition

enum (SessionPosition)

广告在会话中的展示位置。

SessionPosition

会话中可能出现的位置。

枚举
SESSION_POSITION_UNSPECIFIED 这是一个占位符，不表示任何位置。
SESSION_POSITION_FIRST_IMPRESSION 会话的首次展示。

方法

get

 获取分配给广告系列的单个定位选项。

list

 列出为指定定位类型分配给广告系列的定位选项。