REST Resource: partners.targetingTypes.assignedTargetingOptions

Ресурс: AssignedTargetingOption

Один назначенный вариант таргетинга, который определяет состояние варианта таргетинга для объекта с настройками таргетинга.

JSON-представление 
{
  "name": string,
  "assignedTargetingOptionId": string,
  "assignedTargetingOptionIdAlias": string,
  "targetingType": enum (TargetingType),
  "inheritance": enum (Inheritance),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "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)
  },
  "lookalikeAudienceDetails": {
    object (LookalikeAudienceAssignedTargetingOptionDetails)
  },
  "googleAudienceDetails": {
    object (GoogleAudienceAssignedTargetingOptionDetails)
  },
  "customListDetails": {
    object (CustomListAssignedTargetingOptionDetails)
  },
  "combinedAudienceDetails": {
    object (CombinedAudienceAssignedTargetingOptionDetails)
  },
  "firstPartyAndPartnerAudienceDetails": {
    object (FirstPartyAndPartnerAudienceAssignedTargetingOptionDetails)
  },
  "auctionPackageDetails": {
    object (AuctionPackageAssignedTargetingOptionDetails)
  },
  "youtubeChannelPackDetails": {
    object (YoutubeChannelPackAssignedTargetingOptionDetails)
  }
  // End of mutually exclusive fields.
}
Поля
name

string

Только для вывода. Название ресурса для этого назначенного параметра таргетинга.
assignedTargetingOptionId

string

Только для вывода. Уникальный идентификатор назначенного варианта таргетинга. Идентификатор уникален только в пределах определенного ресурса и типа таргетинга. Его можно использовать в других контекстах.
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)

Только для вывода. Статус наследования назначенного параметра таргетинга.
Подробная информация о назначаемом варианте таргетинга. В сведениях можно заполнить только одно поле, и оно должно соответствовать targeting_type. Ниже приведен список взаимоисключающих полей. В ответе будет задано не более одного из следующих полей:
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)

Информация о URL. Это поле будет заполнено, если 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)

Сведения об операторе связи и интернет-провайдере. Это поле будет заполнено, если targetingType – TARGETING_TYPE_CARRIER_AND_ISP.
keywordDetails

object (KeywordAssignedTargetingOptionDetails)

Сведения о ключевом слове. Это поле будет заполнено, если targetingType – TARGETING_TYPE_KEYWORD.

К ресурсу можно напрямую назначить не более 5000 минус-слов. Количество ключевых слов, которые можно назначить, не ограничено.
negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

Сведения о ключевом слове. Это поле будет заполнено, если targetingType – TARGETING_TYPE_NEGATIVE_KEYWORD_LIST.

Ресурсу можно назначить не более четырех списков минус-слов.
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_DEAL.
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)

Сведения об объекте инфраструктуры. Это поле будет заполнено, если 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.
lookalikeAudienceDetails

object (LookalikeAudienceAssignedTargetingOptionDetails)

Сведения о похожей аудитории. Это поле будет заполнено, если targetingType – TARGETING_TYPE_LOOKALIKE_AUDIENCE.
googleAudienceDetails

object (GoogleAudienceAssignedTargetingOptionDetails)

Сведения об аудитории Google. Это поле будет заполнено, если targetingType – TARGETING_TYPE_GOOGLE_AUDIENCE.
customListDetails

object (CustomListAssignedTargetingOptionDetails)

Сведения о списке клиентов. Это поле будет заполнено, если targetingType – TARGETING_TYPE_CUSTOM_LIST.
combinedAudienceDetails

object (CombinedAudienceAssignedTargetingOptionDetails)

Сведения о смешанной аудитории. Это поле будет заполнено, если targetingType – TARGETING_TYPE_COMBINED_AUDIENCE.
firstPartyAndPartnerAudienceDetails

object (FirstPartyAndPartnerAudienceAssignedTargetingOptionDetails)

Сведения о собственных аудиториях и аудиториях партнеров. Это поле будет заполнено, если targetingType – TARGETING_TYPE_FIRST_PARTY_AND_PARTNER_AUDIENCE.
auctionPackageDetails

object (AuctionPackageAssignedTargetingOptionDetails)

Сведения о пакете для аукционов. Это поле заполняется, если значение поля targetingType – TARGETING_TYPE_AUCTION_PACKAGE.
youtubeChannelPackDetails

object (YoutubeChannelPackAssignedTargetingOptionDetails)

Сведения о пакете каналов YouTube. Это поле будет заполнено, если targetingType – TARGETING_TYPE_YOUTUBE_CHANNEL_PACK.
Конец взаимоисключающих полей.

Методы

create

 Назначает партнеру вариант таргетинга.

delete

 Удаляет назначенный вариант таргетинга из партнера.

get

 Возвращает один вариант таргетинга, назначенный партнеру.

list

 Список настроек таргетинга, назначенных партнеру.