REST Resource: advertisers.targetingTypes.assignedTargetingOptions

Recurso: AssignedTargetingOption

Es una única opción de segmentación asignada, que define el estado de una opción de segmentación para una entidad con configuración de segmentación.

Representación 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

Solo salida. El nombre del recurso para esta opción de segmentación asignada.
assignedTargetingOptionId

string

Solo salida. El ID único de la opción de segmentación asignada. El ID solo es único dentro de un recurso y un tipo de segmentación determinados. Es posible que se reutilice en otros contextos.
assignedTargetingOptionIdAlias

string

Solo salida. Un alias para assignedTargetingOptionId. Este valor se puede usar en lugar de assignedTargetingOptionId al recuperar o borrar la segmentación existente.

Este campo solo será compatible con todas las opciones de segmentación asignadas de los siguientes tipos de segmentación:

  • 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 también es compatible con las opciones de segmentación asignadas a líneas de pedido de los siguientes tipos de segmentación:

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
targetingType

enum (TargetingType)

Solo salida. Identifica el tipo de esta opción de segmentación asignada.
inheritance

enum (Inheritance)

Solo salida. El estado de herencia de la opción de segmentación asignada.
Campo de unión details. Información detallada sobre la opción de segmentación que se asigna. Solo se puede completar un campo en los detalles, y debe corresponder a targeting_type. details puede ser solo una de las siguientes opciones:
channelDetails

object (ChannelAssignedTargetingOptionDetails)

Detalles del canal Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_CHANNEL.
appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

Detalles de la categoría de app Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_APP_CATEGORY.
appDetails

object (AppAssignedTargetingOptionDetails)

Detalles de la app Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_APP.
urlDetails

object (UrlAssignedTargetingOptionDetails)

Detalles de la URL. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_URL.
dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

Detalles del día y la hora Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_DAY_AND_TIME.
ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

Detalles del rango de edad. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_AGE_RANGE.
regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

Detalles de la lista de ubicaciones regionales. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_REGIONAL_LOCATION_LIST.
proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

Detalles de la lista de ubicaciones por proximidad. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_PROXIMITY_LOCATION_LIST.
genderDetails

object (GenderAssignedTargetingOptionDetails)

Detalles de género Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_GENDER.
videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

Detalles del tamaño del reproductor de video. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_VIDEO_PLAYER_SIZE.
userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

Detalles del contenido recompensado del usuario. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_USER_REWARDED_CONTENT.
parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

Detalles del estado parental. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_PARENTAL_STATUS.
contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

Detalles de la posición in-stream de contenido. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_CONTENT_INSTREAM_POSITION.
contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

Detalles de la posición outstream del contenido Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.
deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

Detalles del tipo de dispositivo Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_DEVICE_TYPE.
audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

Detalles de la Segmentación por público. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_AUDIENCE_GROUP. Solo puedes orientarte a una opción de grupo de público por recurso.
browserDetails

object (BrowserAssignedTargetingOptionDetails)

Detalles del navegador. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_BROWSER.
householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

Detalles del ingreso familiar Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_HOUSEHOLD_INCOME.
onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

Detalles de posición en pantalla Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_ON_SCREEN_POSITION.
carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

Detalles del ISP y el operador. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_CARRIER_AND_ISP.
keywordDetails

object (KeywordAssignedTargetingOptionDetails)

Detalles de palabra clave Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_KEYWORD.

Se pueden asignar un máximo de 5,000 palabras clave negativas directas a un recurso. No hay límite para la cantidad de palabras clave positivas que se pueden asignar.
negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

Detalles de palabra clave Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_NEGATIVE_KEYWORD_LIST.

Se pueden asignar 4 listas de palabras clave negativas a un recurso como máximo.
operatingSystemDetails

object (OperatingSystemAssignedTargetingOptionDetails)

Detalles del sistema operativo Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_OPERATING_SYSTEM.
deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

Detalles de la marca y el modelo del dispositivo Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_DEVICE_MAKE_MODEL.
environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

Detalles del entorno. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_ENVIRONMENT.
inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

Detalles de la fuente de inventario Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_INVENTORY_SOURCE.
categoryDetails

object (CategoryAssignedTargetingOptionDetails)

Detalles de la categoría Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_CATEGORY.

Al orientarse a una categoría, también se orientarán sus subcategorías. Si se excluye una categoría de la segmentación y se incluye una subcategoría, prevalecerá la exclusión.
viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

Detalles de visibilidad Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_VIEWABILITY.

Solo puede orientarse a una opción de visibilidad por recurso.
authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

Detalles del estado de vendedor autorizado Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

Solo puede orientarse a una opción de estado de vendedor autorizado por recurso.

Si un recurso no tiene una opción de estado de vendedor autorizado, la segmentación de todos los vendedores autorizados que se indique como DIRECTO o REVENDEDOR en el archivo ads.txt es predeterminada.
languageDetails

object (LanguageAssignedTargetingOptionDetails)

Detalles del idioma. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_LANGUAGE.
geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

Detalles de la región geográfica Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_GEO_REGION.
inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

Detalles del grupo de fuentes de inventario. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_INVENTORY_SOURCE_GROUP.
digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

Detalles de la etiqueta de contenido digital. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

Las etiquetas de contenido digital son exclusiones de segmentación. Si se configuran, las exclusiones de etiquetas de contenido digital a nivel del anunciante siempre se aplican en la publicación (aunque no se pueden ver en la configuración de recursos). La configuración de recursos puede excluir etiquetas de contenido además de las exclusiones de anunciantes, pero no puede anularlas. No se publicará una línea de pedido si se excluyen todas las etiquetas de contenido digital.
sensitiveCategoryExclusionDetails

object (SensitiveCategoryAssignedTargetingOptionDetails)

Detalles de categorías sensibles. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

Las categorías sensibles son exclusiones de segmentación. Si se configuran, las exclusiones de categorías sensibles a nivel del anunciante siempre se aplican en la publicación (aunque no se pueden ver en la configuración de recursos). La configuración de recursos puede excluir categorías sensibles además de las exclusiones de anunciantes, pero no puede anularlas.
exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

Detalles del intercambio. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_EXCHANGE.
subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

Detalles del intercambio secundario. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_SUB_EXCHANGE.
thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

Detalles de verificación de terceros Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_THIRD_PARTY_VERIFIER.
poiDetails

object (PoiAssignedTargetingOptionDetails)

Detalles de los lugares de interés. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_POI.
businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

Detalles de la cadena comercial Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_BUSINESS_CHAIN.
contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

Detalles de la duración del contenido Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_CONTENT_DURATION.
contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

Detalles de la duración del contenido Este campo se propagará cuando el tipo de segmentación sea TARGETING_TYPE_CONTENT_STREAM_TYPE.
nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

Detalles de posición de contenido nativo. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_NATIVE_CONTENT_POSITION.
omidDetails

object (OmidAssignedTargetingOptionDetails)

Detalles del inventario habilitado para Open Measurement. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_OMID.
audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

Detalles del tipo de contenido de audio. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_AUDIO_CONTENT_TYPE.
contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

Detalles del género del contenido Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_CONTENT_GENRE.
youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

Detalles del video de YouTube Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_YOUTUBE_VIDEO.
youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

Detalles del canal de YouTube Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_YOUTUBE_CHANNEL.
sessionPositionDetails

object (SessionPositionAssignedTargetingOptionDetails)

Detalles de la posición de la sesión Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_SESSION_POSITION.

Métodos

create

 Asigna una opción de orientación a un anunciante.

delete

 Elimina una opción de segmentación asignada de un anunciante.

get

 Obtiene una sola opción de segmentación asignada a un anunciante.

list

 Indica las opciones de segmentación asignadas a un anunciante.