REST Resource: advertisers.adGroups.targetingTypes.assignedTargetingOptions

资源：AssignedTargetingOption

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

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 时，系统会填充此字段。

每项资源最多可以分配 5,000 个直接否定关键字。可指定的肯定关键字的数量没有限制。
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 时，系统会填充此字段。

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

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

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

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

如果资源没有授权卖方状态选项，则默认定位到 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 应用平台为三星电视。
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 时，系统会在 AssignedTargetingOption 的 details 字段中填充此值。

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 时，系统会在 AssignedTargetingOption 的 details 字段中填充此值。

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 时，系统会在 AssignedTargetingOption 的 details 字段中填充此值。每个组之间的关系为“联合”，但“excludedFirstAndThirdPartyAudienceGroup”和“excludedGoogleAudienceGroup”除外，其中“COMPLEMENT”用作与其他组的“INTERSECTION”。

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

object (FirstAndThirdPartyAudienceGroup)

添加的第一方和第三方受众群体组的第一方和第三方受众群体 ID 和新近度。每个第一方和第三方受众群体组仅包含第一方和第三方受众群体 ID。每个第一方受众群体与第三方受众群体之间的关系为“INTERSECTION”，结果会与其他受众群体进行“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 的补集将用作任何正例受众群体定位的 INTERSECTION。仅包含兴趣相似的受众群体、有购买意向的受众群体和已安装应用的受众群体类型的 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 时，系统会在 AssignedTargetingOption 的 details 字段中填充此值。

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

string

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

string

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

boolean

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

HouseholdIncomeAssignedTargetingOptionDetails

分配的家庭收入定位选项的详细信息。当 targetingType 为 TARGETING_TYPE_HOUSEHOLD_INCOME 时，系统会在 AssignedTargetingOption 的 details 字段中填充此值。

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 时，此值将会填充到 AssignTargetingOption 的详情字段中。

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 时，系统会在 AssignedTargetingOption 的 details 字段中填充此值。

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 时，系统会在 AssignedTargetingOption 的 details 字段中填充此值。

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

enum (Environment)

必需。投放环境。

InventorySourceAssignedTargetingOptionDetails

广告资源来源的定位详细信息。当 targetingType 为 TARGETING_TYPE_INVENTORY_SOURCE 时，系统会在 AssignedTargetingOption 的 details 字段中填充此值。

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 时，系统会在 AssignedTargetingOption 的 details 字段中填充此值。

如果资源未分配 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 时，系统会在 AssignedTargetingOption 的 details 字段中填充此值。

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 时，系统会在 AssignedTargetingOption 的 details 字段中填充此值。

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

enum (ContentRatingTier)

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

SensitiveCategoryAssignedTargetingOptionDetails

敏感类别的定位详细信息。当 targetingType 为 TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION 时，系统会在 AssignedTargetingOption 的 details 字段中填充此值。

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)
  ],
  "excludedFraudIvtMfaCategories": [
    enum (FraudIvtMfaCategory)
  ],
  "adultExplicitSexualContent": enum (GarmRiskExclusion),
  "crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent": enum (GarmRiskExclusion),
  "armsAmmunitionContent": enum (GarmRiskExclusion),
  "deathInjuryMilitaryConflictContent": enum (GarmRiskExclusion),
  "debatedSensitiveSocialIssueContent": enum (GarmRiskExclusion),
  "illegalDrugsTobaccoEcigarettesVapingAlcoholContent": enum (GarmRiskExclusion),
  "onlinePiracyContent": enum (GarmRiskExclusion),
  "hateSpeechActsAggressionContent": enum (GarmRiskExclusion),
  "obscenityProfanityContent": enum (GarmRiskExclusion),
  "spamHarmfulContent": enum (GarmRiskExclusion),
  "terrorismContent": enum (GarmRiskExclusion),
  "misinformationContent": enum (GarmRiskExclusion),
  "displayIabViewability": enum (DisplayIabViewability),
  "videoIabViewability": enum (VideoIabViewability)
}
字段
excludedAdlooxCategories[]

enum (AdlooxCategory)

要排除的 Adloox 类别。
excludedFraudIvtMfaCategories[]

enum (FraudIvtMfaCategory)

可选。要排除的 Adloox 欺诈 IVT MFA 类别。
adultExplicitSexualContent

enum (GarmRiskExclusion)

可选。要排除的成人内容和露骨色情内容 GARM 风险范围。
crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent

enum (GarmRiskExclusion)

可选。要排除的犯罪与有害行为内容 GARM 风险范围。
armsAmmunitionContent

enum (GarmRiskExclusion)

可选。要排除的武器与弹药内容 GARM 风险范围。
deathInjuryMilitaryConflictContent

enum (GarmRiskExclusion)

可选。要排除的“死亡、受伤或军事冲突内容”GARM 风险范围。
debatedSensitiveSocialIssueContent

enum (GarmRiskExclusion)

可选。要排除的“有争议的敏感社会问题内容”GARM 风险范围。
illegalDrugsTobaccoEcigarettesVapingAlcoholContent

enum (GarmRiskExclusion)

可选。要排除的违禁药品/酒精饮料内容 GARM 风险范围。
onlinePiracyContent

enum (GarmRiskExclusion)

可选。要排除的“在线盗版内容”GARM 风险范围。
hateSpeechActsAggressionContent

enum (GarmRiskExclusion)

可选。要排除的仇恨言论和攻击性内容 GARM 风险范围。
obscenityProfanityContent

enum (GarmRiskExclusion)

可选。要排除的淫秽与脏话内容 GARM 风险范围。
spamHarmfulContent

enum (GarmRiskExclusion)

可选。要排除的垃圾内容或有害内容 GARM 风险范围。
terrorismContent

enum (GarmRiskExclusion)

可选。要排除的恐怖主义内容 GARM 风险范围。
misinformationContent

enum (GarmRiskExclusion)

可选。要排除的虚假信息内容 GARM 风险范围。
displayIabViewability

enum (DisplayIabViewability)

可选。展示广告的 IAB 可见度阈值。
videoIabViewability

enum (VideoIabViewability)

可选。视频广告的 IAB 可见度阈值。

AdlooxCategory

可用的 Adloox 类别。

枚举
ADLOOX_UNSPECIFIED 当此版本中未指定 Adloox 类别或 Adloox 类别未知时，采用默认值。
ADULT_CONTENT_HARD 成人内容（重口味）。
ADULT_CONTENT_SOFT 成人内容（软色情）。
ILLEGAL_CONTENT 非法内容。
BORDERLINE_CONTENT 擦边球内容。
DISCRIMINATORY_CONTENT 歧视性内容。
VIOLENT_CONTENT_WEAPONS 暴力内容和武器。
LOW_VIEWABILITY_DOMAINS 可见度较低的网域。
FRAUD 欺诈。

FraudIvtMfaCategory

可用的 Adloox 欺诈、无效流量、MFA 类别。

枚举
FRAUD_IVT_MFA_CATEGORY_UNSPECIFIED 当 Adloox 欺诈、IVT、MFA 类别未指定或在此版本中未知时，采用默认值。
FRAUD_IVT_MFA FRAUD、IVT、MFA。

GarmRiskExclusion

可用的 GARM 风险级别排除选项。

枚举
GARM_RISK_EXCLUSION_UNSPECIFIED 此枚举只是一个占位符，未指定任何 GARM 风险排除选项。
GARM_RISK_EXCLUSION_FLOOR 排除底价风险。
GARM_RISK_EXCLUSION_HIGH 排除高风险和最低风险。
GARM_RISK_EXCLUSION_MEDIUM 排除中风险、高风险和最低风险。
GARM_RISK_EXCLUSION_LOW 排除所有风险级别（低、中、高和最低）。

DisplayIabViewability

可用的 Adloox IAB 展示广告可见度阈值。

枚举
DISPLAY_IAB_VIEWABILITY_UNSPECIFIED 在此版本中，如果未指定或未知，则为默认值。
DISPLAY_IAB_VIEWABILITY_10 10%+ 被观看（IAB 展示广告可见度标准）。
DISPLAY_IAB_VIEWABILITY_20 20%+ 被观看（IAB 展示广告可见度标准）。
DISPLAY_IAB_VIEWABILITY_35 35%+ 被观看（IAB 展示广告可见度标准）。
DISPLAY_IAB_VIEWABILITY_50 50%+ 被观看（IAB 展示广告可见度标准）。
DISPLAY_IAB_VIEWABILITY_75 75% 以上可见（IAB 展示广告可见度标准）。

VideoIabViewability

Adloox 提供的 IAB 视频广告可见度阈值。

枚举
VIDEO_IAB_VIEWABILITY_UNSPECIFIED 在此版本中未指定或未知时的默认值。
VIDEO_IAB_VIEWABILITY_10 可见度达到 10% 或更高（IAB 视频可见度标准）。
VIDEO_IAB_VIEWABILITY_20 可见度达到 20% 以上（IAB 视频可见度标准）。
VIDEO_IAB_VIEWABILITY_35 可见度达到 35% 以上（IAB 视频可见度标准）。
VIDEO_IAB_VIEWABILITY_50 可见度超过 50%（IAB 视频可见度标准）。
VIDEO_IAB_VIEWABILITY_75 75%以上的可见度（IAB 视频可见度标准）。

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

针对历史欺诈性及无效流量比率的可能选项。

枚举
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 欺诈性及无效流量比率为 8% 或更高。
AD_IMPRESSION_FRAUD_6 欺诈性及无效流量比率为 6% 或更高。
AD_IMPRESSION_FRAUD_4 欺诈性及无效流量比率为 4% 或更高。
AD_IMPRESSION_FRAUD_2 欺诈性及无效流量比率为 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_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 时，系统会在 AssignedTargetingOption 的 details 字段中填充此值。

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 Miles。
DISTANCE_UNIT_KILOMETERS 公里。

BusinessChainAssignedTargetingOptionDetails

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

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

string

仅限输出。连锁商家的显示名称，例如“肯德基”“美国银行”。
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

 列出分配给广告组的定位选项。