REST Resource: advertisers.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

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

assigned Targeting Option Id

string

Только вывод. Уникальный идентификатор назначенного параметра таргетинга. Идентификатор уникален только в пределах данного ресурса и типа таргетинга. Его можно повторно использовать в других контекстах.

assigned Targeting Option Id Alias

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
targeting Type

enum ( TargetingType )

Только вывод. Определяет тип назначенного параметра таргетинга.

inheritance

enum ( Inheritance )

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

details поля объединения. Подробная информация о назначаемом параметре таргетинга. Детально может быть заполнено только одно поле, и оно должно соответствовать targeting_type ; details могут быть только одним из следующих:
channel Details

object ( ChannelAssignedTargetingOptionDetails )

Подробности о канале. Это поле будет заполнено, если для targetingType установлено значение TARGETING_TYPE_CHANNEL .

app Category Details

object ( AppCategoryAssignedTargetingOptionDetails )

Подробности о категории приложений. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_APP_CATEGORY .

app Details

object ( AppAssignedTargetingOptionDetails )

Подробности приложения. Это поле будет заполнено, если для targetingType установлено значение TARGETING_TYPE_APP .

url Details

object ( UrlAssignedTargetingOptionDetails )

Подробности URL-адреса. Это поле будет заполнено, если для targetingType установлено значение TARGETING_TYPE_URL .

day And Time Details

object ( DayAndTimeAssignedTargetingOptionDetails )

Детали дня и времени. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_DAY_AND_TIME .

age Range Details

object ( AgeRangeAssignedTargetingOptionDetails )

Подробности о возрастном диапазоне. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_AGE_RANGE .

regional Location List Details

object ( RegionalLocationListAssignedTargetingOptionDetails )

Детали списка региональных местоположений. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_REGIONAL_LOCATION_LIST .

proximity Location List Details

object ( ProximityLocationListAssignedTargetingOptionDetails )

Детали списка ближайших местоположений. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_PROXIMITY_LOCATION_LIST .

gender Details

object ( GenderAssignedTargetingOptionDetails )

Половые данные. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_GENDER .

video Player Size Details

object ( VideoPlayerSizeAssignedTargetingOptionDetails )

Детали размера видеоплеера. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_VIDEO_PLAYER_SIZE .

user Rewarded Content Details

object ( UserRewardedContentAssignedTargetingOptionDetails )

Подробности о контенте, вознагражденном пользователем. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_USER_REWARDED_CONTENT .

parental Status Details

object ( ParentalStatusAssignedTargetingOptionDetails )

Детали родительского статуса. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_PARENTAL_STATUS .

content Instream Position Details

object ( ContentInstreamPositionAssignedTargetingOptionDetails )

Сведения о позиции In-Stream контента. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_CONTENT_INSTREAM_POSITION .

content Outstream Position Details

object ( ContentOutstreamPositionAssignedTargetingOptionDetails )

Сведения о позиции исходящего контента. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION .

device Type Details

object ( DeviceTypeAssignedTargetingOptionDetails )

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

audience Group Details

object ( AudienceGroupAssignedTargetingOptionDetails )

Детали таргетинга аудитории. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_AUDIENCE_GROUP . Для каждого ресурса можно настроить таргетинг только на один вариант группы аудитории.

browser Details

object ( BrowserAssignedTargetingOptionDetails )

Детали браузера. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_BROWSER .

household Income Details

object ( HouseholdIncomeAssignedTargetingOptionDetails )

Подробности о семейном доходе. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_HOUSEHOLD_INCOME .

on Screen Position Details

object ( OnScreenPositionAssignedTargetingOptionDetails )

Детали положения на экране. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_ON_SCREEN_POSITION .

carrier And Isp Details

object ( CarrierAndIspAssignedTargetingOptionDetails )

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

keyword Details

object ( KeywordAssignedTargetingOptionDetails )

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

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

negative Keyword List Details

object ( NegativeKeywordListAssignedTargetingOptionDetails )

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

Ресурсу можно назначить максимум 4 списка минус-слов.

operating System Details

object ( OperatingSystemAssignedTargetingOptionDetails )

Подробности об операционной системе. Это поле будет заполнено, если targetingType имеет значение TARGETING_TYPE_OPERATING_SYSTEM .

device Make Model Details

object ( DeviceMakeModelAssignedTargetingOptionDetails )

Сведения о производителе и модели устройства. Это поле будет заполнено, если targetingType имеет значение TARGETING_TYPE_DEVICE_MAKE_MODEL .

environment Details

object ( EnvironmentAssignedTargetingOptionDetails )

Детали окружения. Это поле будет заполнено, если targetingType имеет значение TARGETING_TYPE_ENVIRONMENT .

inventory Source Details

object ( InventorySourceAssignedTargetingOptionDetails )

Сведения об источнике инвентаря. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_INVENTORY_SOURCE .

category Details

object ( CategoryAssignedTargetingOptionDetails )

Детали категории. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_CATEGORY .

Таргетинг на категорию также будет нацелен на ее подкатегории. Если категория исключена из таргетинга и включена подкатегория, исключение будет иметь приоритет.

viewability Details

object ( ViewabilityAssignedTargetingOptionDetails )

Подробности о видимости. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_VIEWABILITY .

Для каждого ресурса можно настроить таргетинг только на один вариант видимости.

authorized Seller Status Details

object ( AuthorizedSellerStatusAssignedTargetingOptionDetails )

Подробности статуса авторизованного продавца. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_AUTHORIZED_SELLER_STATUS .

Для каждого ресурса можно настроить таргетинг только на один вариант статуса авторизованного продавца.

Если у ресурса нет опции статуса авторизованного продавца, по умолчанию таргетингом становятся все авторизованные продавцы, указанные как ПРЯМЫЕ или ПОСРЕДНИКИ в файлеads.txt.

language Details

object ( LanguageAssignedTargetingOptionDetails )

Языковые детали. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_LANGUAGE .

geo Region Details

object ( GeoRegionAssignedTargetingOptionDetails )

Подробности географического региона. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_GEO_REGION .

inventory Source Group Details

object ( InventorySourceGroupAssignedTargetingOptionDetails )

Сведения о группе источников инвентаря. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_INVENTORY_SOURCE_GROUP .

digital Content Label Exclusion Details

object ( DigitalContentLabelAssignedTargetingOptionDetails )

Подробности метки цифрового контента. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION .

Ярлыки цифрового контента ориентированы на исключения. Исключения меток цифрового контента на уровне рекламодателя, если они установлены, всегда применяются при показе (даже если они не отображаются в настройках ресурса). Настройки ресурса могут исключать ярлыки контента в дополнение к исключениям рекламодателей, но не могут их переопределять. Позиция не будет показываться, если исключить все ярлыки цифрового контента.

sensitive Category Exclusion Details

object ( SensitiveCategoryAssignedTargetingOptionDetails )

Детали деликатной категории. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION .

Деликатные категории ориентированы на исключения. Исключения деликатных категорий на уровне рекламодателя, если они установлены, всегда применяются при показе (даже если они не отображаются в настройках ресурса). Настройки ресурса могут исключать деликатные категории в дополнение к исключениям рекламодателей, но не могут их переопределять.

exchange Details

object ( ExchangeAssignedTargetingOptionDetails )

Детали обмена. Это поле будет заполнено, если targetingType имеет TARGETING_TYPE_EXCHANGE .

sub Exchange Details

object ( SubExchangeAssignedTargetingOptionDetails )

Детали суббиржи. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_SUB_EXCHANGE .

third Party Verifier Details

object ( ThirdPartyVerifierAssignedTargetingOptionDetails )

Подробности проверки третьей стороной. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_THIRD_PARTY_VERIFIER .

poi Details

object ( PoiAssignedTargetingOptionDetails )

Детали POI. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_POI .

business Chain Details

object ( BusinessChainAssignedTargetingOptionDetails )

Детали бизнес-цепочки. Это поле будет заполнено, если targetingType имеет значение TARGETING_TYPE_BUSINESS_CHAIN .

content Duration Details

object ( ContentDurationAssignedTargetingOptionDetails )

Подробности о продолжительности контента. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_CONTENT_DURATION .

content Stream Type Details

object ( ContentStreamTypeAssignedTargetingOptionDetails )

Подробности о продолжительности контента. Это поле будет заполнено, если TargetingType имеет значение TARGETING_TYPE_CONTENT_STREAM_TYPE .

native Content Position Details

object ( NativeContentPositionAssignedTargetingOptionDetails )

Детали позиции нативного контента. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_NATIVE_CONTENT_POSITION .

omid Details

object ( OmidAssignedTargetingOptionDetails )

Сведения об инвентаризации с включенной функцией Open Measurement. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_OMID .

audio Content Type Details

object ( AudioContentTypeAssignedTargetingOptionDetails )

Подробности о типах аудиоконтента. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_AUDIO_CONTENT_TYPE .

content Genre Details

object ( ContentGenreAssignedTargetingOptionDetails )

Детали жанра контента. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_CONTENT_GENRE .

youtube Video Details

object ( YoutubeVideoAssignedTargetingOptionDetails )

Подробности видео на YouTube. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_YOUTUBE_VIDEO .

youtube Channel Details

object ( YoutubeChannelAssignedTargetingOptionDetails )

Подробности о канале YouTube. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_YOUTUBE_CHANNEL .

session Position Details

object ( SessionPositionAssignedTargetingOptionDetails )

Детали позиции сессии. Это поле будет заполнено, если для targetingType установлено TARGETING_TYPE_SESSION_POSITION .

Методы

create

 Назначает рекламодателю параметр таргетинга.

delete

 Удаляет назначенный параметр таргетинга у рекламодателя.

get

 Получает один вариант таргетинга, назначенный рекламодателю.

list

 Перечисляет параметры таргетинга, назначенные рекламодателю.