REST Resource: advertisers.campaigns.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)
  },
  "contentThemeExclusionDetails": {
    object (ContentThemeAssignedTargetingOptionDetails)
  },
  "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。有关所分配的定位选项的详细信息。详细信息中只能填写一个字段，并且该字段必须与 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 时，系统会填充此字段。

每个资源只能定位一个观看度选项。
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 时，系统会填充此字段。

敏感类别是定位排除对象。如果设置了广告客户级敏感类别排除对象，系统在投放广告时始终会应用这些排除对象（即使它们未显示在资源设置中）。资源设置除了可以排除广告客户排除的敏感类别之外，还可以排除其他敏感类别，但不能替换广告客户排除的敏感类别。
contentThemeExclusionDetails

object (ContentThemeAssignedTargetingOptionDetails)

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

POI 详细信息。当 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 时，系统会填充此字段。

方法

get

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

list

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