REST Resource: advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions

Recurso: AssignedSegmentaçãoOption

Uma única opção de segmentação atribuída, que define o estado de uma opção de segmentação para uma entidade com configurações de segmentação.

Representação 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.
}
Campos
name

string

Apenas saída. O nome do recurso dessa opção de segmentação atribuída.
assignedTargetingOptionId

string

Apenas saída. O ID exclusivo da opção de segmentação atribuída. O ID só é exclusivo em um determinado recurso e tipo de segmentação. Eles poderão ser reutilizados em outros contextos.
assignedTargetingOptionIdAlias

string

Apenas saída. Um alias para assignedTargetingOptionId. Esse valor pode ser usado no lugar de assignedTargetingOptionId ao recuperar ou excluir a segmentação existente.

Esse campo só é compatível com todas as opções de segmentação atribuídas dos seguintes tipos:

  • 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

Este campo também é compatível com opções de segmentação atribuídas a itens de linha dos seguintes tipos:

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
targetingType

enum (TargetingType)

Apenas saída. Identifica o tipo dessa opção de segmentação atribuída.
inheritance

enum (Inheritance)

Apenas saída. O status de herança da opção de segmentação atribuída.
Campo de união details. Informações detalhadas sobre a opção de segmentação que está sendo atribuída. Somente um campo detalhado pode ser preenchido, e precisa corresponder a targeting_type. details só pode ser uma das seguintes opções:
channelDetails

object (ChannelAssignedTargetingOptionDetails)

Detalhes do canal. Este campo será preenchido quando targetingType for TARGETING_TYPE_CHANNEL.
appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

Detalhes da categoria do app. Este campo será preenchido quando targetingType for TARGETING_TYPE_APP_CATEGORY.
appDetails

object (AppAssignedTargetingOptionDetails)

Detalhes do app. Este campo será preenchido quando targetingType for TARGETING_TYPE_APP.
urlDetails

object (UrlAssignedTargetingOptionDetails)

Detalhes do URL. Este campo será preenchido quando targetingType for TARGETING_TYPE_URL.
dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

Detalhes de dia e hora. Este campo será preenchido quando targetingType for TARGETING_TYPE_DAY_AND_TIME.
ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

Detalhes da faixa etária. Este campo será preenchido quando targetingType for TARGETING_TYPE_AGE_RANGE.
regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

Detalhes da lista de locais regionais. Este campo será preenchido quando targetingType for TARGETING_TYPE_REGIONAL_LOCATION_LIST.
proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

Detalhes da lista de localização por proximidade. Este campo será preenchido quando targetingType for TARGETING_TYPE_PROXIMITY_LOCATION_LIST.
genderDetails

object (GenderAssignedTargetingOptionDetails)

Detalhes do sexo. Este campo será preenchido quando targetingType for TARGETING_TYPE_GENDER.
videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

Detalhes do tamanho do player de vídeo. Este campo será preenchido quando targetingType for TARGETING_TYPE_VIDEO_PLAYER_SIZE.
userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

Detalhes do conteúdo com prêmio para o usuário. Este campo será preenchido quando targetingType for TARGETING_TYPE_USER_REWARDED_CONTENT.
parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

Detalhes do status parental. Este campo será preenchido quando targetingType for TARGETING_TYPE_PARENTAL_STATUS.
contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

Detalhes da posição in-stream do conteúdo Este campo será preenchido quando targetingType for TARGETING_TYPE_CONTENT_INSTREAM_POSITION.
contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

Detalhes da posição out-stream do conteúdo Este campo será preenchido quando targetingType for TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.
deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

Detalhes do tipo de dispositivo. Este campo será preenchido quando targetingType for TARGETING_TYPE_DEVICE_TYPE.
audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

Detalhes da segmentação por público-alvo. Este campo será preenchido quando targetingType for TARGETING_TYPE_AUDIENCE_GROUP. Só é possível segmentar uma opção de grupo de público por recurso.
browserDetails

object (BrowserAssignedTargetingOptionDetails)

Detalhes do navegador. Este campo será preenchido quando targetingType for TARGETING_TYPE_BROWSER.
householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

Detalhes da renda familiar. Este campo será preenchido quando targetingType for TARGETING_TYPE_HOUSEHOLD_INCOME.
onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

Detalhes sobre a posição na tela. Este campo será preenchido quando targetingType for TARGETING_TYPE_ON_SCREEN_POSITION.
carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

Detalhes da operadora e do ISP. Este campo será preenchido quando targetingType for TARGETING_TYPE_CARRIER_AND_ISP.
keywordDetails

object (KeywordAssignedTargetingOptionDetails)

Detalhes da palavra-chave. Este campo será preenchido quando targetingType for TARGETING_TYPE_KEYWORD.

É possível atribuir no máximo 5.000 palavras-chave negativas diretas a um recurso. Não há limite para o número de palavras-chave positivas que podem ser atribuídas.
negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

Detalhes da palavra-chave. Este campo será preenchido quando targetingType for TARGETING_TYPE_NEGATIVE_KEYWORD_LIST.

É possível atribuir no máximo quatro listas de palavras-chave negativas a um recurso.
operatingSystemDetails

object (OperatingSystemAssignedTargetingOptionDetails)

Detalhes do sistema operacional. Este campo será preenchido quando targetingType for TARGETING_TYPE_OPERATING_SYSTEM.
deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

Detalhes da marca e do modelo do dispositivo Este campo será preenchido quando targetingType for TARGETING_TYPE_DEVICE_MAKE_MODEL.
environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

Detalhes do ambiente. Este campo será preenchido quando targetingType for TARGETING_TYPE_ENVIRONMENT.
inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

Detalhes da origem de inventário. Este campo será preenchido quando targetingType for TARGETING_TYPE_INVENTORY_SOURCE.
categoryDetails

object (CategoryAssignedTargetingOptionDetails)

Detalhes da categoria. Este campo será preenchido quando targetingType for TARGETING_TYPE_CATEGORY.

A segmentação de uma categoria também segmenta suas subcategorias. Se uma categoria for excluída da segmentação e uma subcategoria for incluída, a exclusão prevalecerá.
viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

Detalhes de visibilidade. Este campo será preenchido quando targetingType for TARGETING_TYPE_VIEWABILITY.

Só é possível segmentar uma opção de visibilidade por recurso.
authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

Detalhes do status do vendedor autorizado. Este campo será preenchido quando targetingType for TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

Só é possível segmentar uma opção de status de vendedor autorizado por recurso.

Se um recurso não tiver uma opção de status de vendedor autorizado, todos os vendedores autorizados indicados como DIRETO ou REVENDEDOR no arquivo ads.txt serão segmentados por padrão.
languageDetails

object (LanguageAssignedTargetingOptionDetails)

Detalhes do idioma. Este campo será preenchido quando targetingType for TARGETING_TYPE_LANGUAGE.
geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

Detalhes da região geográfica. Este campo será preenchido quando targetingType for TARGETING_TYPE_GEO_REGION.
inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

Detalhes do grupo de origem de inventário. Este campo será preenchido quando targetingType for TARGETING_TYPE_INVENTORY_SOURCE_GROUP.
digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

Detalhes da classificação de conteúdo digital Este campo será preenchido quando targetingType for TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

As classificações de conteúdo digital são exclusões de segmentação. As exclusões de classificação de conteúdo digital no nível do anunciante, se definidas, são sempre aplicadas na veiculação, mesmo que não estejam visíveis nas configurações de recursos. As configurações de recursos podem excluir classificações de conteúdo e de anunciantes, mas não podem modificá-las. Um item de linha não será veiculado se todas as classificações de conteúdo digital forem excluídas.
sensitiveCategoryExclusionDetails

object (SensitiveCategoryAssignedTargetingOptionDetails)

Detalhes da categoria sensível. Este campo será preenchido quando targetingType for TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

As categorias sensíveis são exclusões de segmentação. As exclusões de categoria sensível no nível do anunciante, se definidas, são sempre aplicadas na veiculação, mesmo que não estejam visíveis nas configurações de recursos. As configurações de recursos podem excluir categorias sensíveis, além de exclusões de anunciantes, mas não podem substituí-las.
exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

Detalhes da troca. Este campo será preenchido quando targetingType for TARGETING_TYPE_EXCHANGE.
subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

Detalhes da subtroca. Este campo será preenchido quando targetingType for TARGETING_TYPE_SUB_EXCHANGE.
thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

Detalhes da verificação de terceiros. Este campo será preenchido quando targetingType for TARGETING_TYPE_THIRD_PARTY_VERIFIER.
poiDetails

object (PoiAssignedTargetingOptionDetails)

Detalhes do PDI. Este campo será preenchido quando targetingType for TARGETING_TYPE_POI.
businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

Detalhes da rede de negócios. Este campo será preenchido quando targetingType for TARGETING_TYPE_BUSINESS_CHAIN.
contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

Detalhes da duração do conteúdo. Este campo será preenchido quando targetingType for TARGETING_TYPE_CONTENT_DURATION.
contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

Detalhes da duração do conteúdo. Esse campo será preenchido quando o TargetingType for TARGETING_TYPE_CONTENT_STREAM_TYPE.
nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

Detalhes da posição do conteúdo nativo. Este campo será preenchido quando targetingType for TARGETING_TYPE_NATIVE_CONTENT_POSITION.
omidDetails

object (OmidAssignedTargetingOptionDetails)

Detalhes do inventário com Open Measurement ativado. Este campo será preenchido quando targetingType for TARGETING_TYPE_OMID.
audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

Detalhes do tipo de conteúdo de áudio. Este campo será preenchido quando targetingType for TARGETING_TYPE_AUDIO_CONTENT_TYPE.
contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

Detalhes do gênero do conteúdo. Este campo será preenchido quando targetingType for TARGETING_TYPE_CONTENT_GENRE.
youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

Detalhes do vídeo do YouTube. Este campo será preenchido quando targetingType for TARGETING_TYPE_YOUTUBE_VIDEO.
youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

Detalhes do canal do YouTube. Este campo será preenchido quando targetingType for TARGETING_TYPE_YOUTUBE_CHANNEL.
sessionPositionDetails

object (SessionPositionAssignedTargetingOptionDetails)

Detalhes sobre a posição na sessão. Este campo será preenchido quando targetingType for TARGETING_TYPE_SESSION_POSITION.

Métodos

get

 Recebe uma única opção de segmentação atribuída a um grupo de anúncios do YouTube.

list

 Lista as opções de segmentação atribuídas a um grupo de anúncios do YouTube.