REST Resource: advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations

Recurso: YoutubeAssetAssociation

Es una asociación entre un recurso y un activo de YouTube.

Representación JSON 
{
  "name": string,
  "youtubeAssetType": enum (YoutubeAssetType),
  "linkedYoutubeAsset": {
    object (LinkedYouTubeAsset)
  }
}
Campos
name

string

Es el identificador. Es el nombre del recurso de la asociación.

Para las asociaciones a nivel del concepto: El patrón de nombre es advertisers/{advertiserId}/lineItems/{lineItemId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations/{youtubeAssetAssociationId}.

En el caso de las asociaciones a nivel del grupo de anuncios, el patrón de nombres es advertisers/{advertiserId}/adGroups/{adGroupId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations/{youtubeAssetAssociationId}.

Para las asociaciones de YOUTUBE_ASSET_TYPE_LOCATION y YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION, youtubeAssetAssociationId es el ID del conjunto de recursos vinculado o 0 si locationMatchingType o affiliateLocationMatchingType es DISABLED.

Para las asociaciones de YOUTUBE_ASSET_TYPE_SITELINK, youtubeAssetAssociationId es el ID del recurso de vínculo a sitio vinculado.
youtubeAssetType

enum (YoutubeAssetType)

Obligatorio. Es el tipo de activo de YouTube asociado con el recurso.
linkedYoutubeAsset

object (LinkedYouTubeAsset)

Obligatorio. Es el activo de YouTube asociado con el recurso.

YoutubeAssetType

Son los tipos posibles de recursos de YouTube.

Estos recursos mostrarán información adicional junto con los anuncios durante la publicación.

Enums
YOUTUBE_ASSET_TYPE_UNSPECIFIED El tipo de recurso de YouTube no se especificó o es desconocido en esta versión.
YOUTUBE_ASSET_TYPE_LOCATION Es un recurso de ubicación.
YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION Es el recurso de ubicación afiliada.

LinkedYouTubeAsset

Es un activo de YouTube vinculado a un recurso en un objeto YoutubeAssetAssociation.

Representación JSON 
{

  // Union field youtube_asset can be only one of the following:
  "locationAssetFilter": {
    object (LocationAssetFilter)
  },
  "affiliateLocationAssetFilter": {
    object (AffiliateLocationAssetFilter)
  },
  "sitelinkAsset": {
    object (SitelinkAsset)
  }
  // End of list of possible types for union field youtube_asset.
}
Campos
Campo de unión youtube_asset. Es el activo de YouTube. Las direcciones (youtube_asset) solo pueden ser una de las siguientes opciones:
locationAssetFilter

object (LocationAssetFilter)

Es un filtro de recursos de ubicación.

Solo se puede configurar cuando youtubeAssetType es YOUTUBE_ASSET_TYPE_LOCATION.
affiliateLocationAssetFilter

object (AffiliateLocationAssetFilter)

Es un filtro de recursos de ubicación afiliada.

Solo se puede configurar cuando youtubeAssetType es YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION.

LocationAssetFilter

Es un filtro de recursos que coincide con los recursos de ubicación aptos para la publicación.

Representación JSON 
{
  "locationMatchingType": enum (LocationMatchingType),
  "assetSetId": string,
  "locationMatchingFunction": {
    object (LocationMatchingFunction)
  }
}
Campos
locationMatchingType

enum (LocationMatchingType)

Obligatorio. Es el tipo de coincidencia de este filtro de recursos de ubicación.
assetSetId

string (int64 format)

Solo salida. Es el ID del conjunto de recursos que coincide con los recursos de ubicación aptos para la publicación.
locationMatchingFunction

object (LocationMatchingFunction)

Opcional. Es la función de coincidencia que indica cómo el filtro de recursos de ubicación coincide con los recursos de ubicación.

Este campo es obligatorio y solo se puede configurar si locationMatchingType es FILTER o SELECTED_ASSETS.

LocationMatchingType

Son los posibles tipos de coincidencias que deciden qué recursos de ubicación son aptos para publicarse.

Enums
LOCATION_MATCHING_TYPE_UNSPECIFIED El tipo de coincidencia de ubicación no se especificó o es desconocido en esta versión.
SELECT_ALL Todos los recursos de ubicación disponibles son aptos para publicarse.
FILTER Se pueden publicar los recursos de ubicación que coincidan con los filtros de etiqueta o nombre de la empresa proporcionados.
SELECTED_ASSETS Solo se pueden publicar los recursos de ubicación seleccionados.
DISABLED No se pueden publicar recursos de ubicación.

LocationMatchingFunction

Es la función de coincidencia para un filtro de recursos de ubicación.

Representación JSON 
{
  "labels": [
    string
  ],
  "locationAssetIds": [
    string
  ],
  "business": string
}
Campos
labels[]

string

Opcional. Es la etiqueta con la que se debe coincidir.

Las etiquetas se combinan de forma lógica con el operador OR.

Este campo es opcional y solo se puede configurar si locationMatchingType es FILTER.
locationAssetIds[]

string (int64 format)

Opcional. Son los IDs de los recursos de ubicación seleccionados.

Este campo es obligatorio si locationMatchingType es SELECTED_ASSETS.
business

string

Opcional. Es el nombre de la empresa con el que se debe coincidir.

Este campo es opcional y solo se puede configurar si locationMatchingType es FILTER.

AffiliateLocationAssetFilter

Es un filtro de recursos que coincide con los recursos de ubicación afiliada aptos para la publicación.

Representación JSON 
{
  "affiliateLocationMatchingType": enum (AffiliateLocationMatchingType),
  "assetSetId": string,
  "affiliateLocationMatchingFunction": {
    object (AffiliateLocationMatchingFunction)
  }
}
Campos
affiliateLocationMatchingType

enum (AffiliateLocationMatchingType)

Obligatorio. Es el tipo de coincidencia de este filtro de recursos de ubicación afiliada.
assetSetId

string (int64 format)

Solo salida. Es el ID del conjunto de recursos que coincide con los recursos de ubicación afiliada aptos para la publicación.
affiliateLocationMatchingFunction

object (AffiliateLocationMatchingFunction)

Opcional. Es la función de coincidencia que indica cómo el filtro de recursos de ubicación afiliada coincide con los recursos de ubicación afiliada.

Este campo es obligatorio y solo se puede configurar si affiliateLocationMatchingType es SELECTED_CHAINS.

AffiliateLocationMatchingType

Son los posibles tipos de coincidencias que deciden qué recursos de ubicación afiliada son aptos para la publicación.

Enums
AFFILIATE_LOCATION_MATCHING_TYPE_UNSPECIFIED El tipo de coincidencia de ubicación afiliada no se especificó o se desconoce en esta versión.
SELECT_ALL Todos los recursos de ubicación afiliada disponibles son aptos para publicarse.
SELECTED_CHAINS Se pueden publicar los recursos de ubicación afiliada seleccionados.
DISABLED No se pueden publicar recursos de ubicación afiliada.

AffiliateLocationMatchingFunction

Es la función de coincidencia para un filtro de recursos de ubicación afiliada.

Representación JSON 
{
  "chains": [
    {
      object (AffiliateLocationChain)
    }
  ]
}
Campos
chains[]

object (AffiliateLocationChain)

Opcional. Son los IDs de la cadena de ubicaciones afiliadas seleccionada.

Este campo es obligatorio si affiliateLocationMatchingType es SELECTED_CHAINS.

AffiliateLocationChain

Es una cadena de ubicaciones afiliadas.

Representación JSON 
{
  "chainId": string
}
Campos
chainId

string (int64 format)

Obligatorio. Es el ID de la cadena de ubicaciones afiliadas.

SitelinkAsset

Es un recurso de vínculo a sitio.

Representación JSON 
{
  "assetId": string
}
Campos
assetId

string (int64 format)

Obligatorio. Es el ID del recurso de vínculo a sitio.

Métodos

create

 Crea una asociación nueva entre el recurso identificado y un activo de YouTube.

delete

 Borra una asociación existente entre el recurso identificado y un recurso de YouTube.

list

 Enumera las asociaciones de activos de YouTube vinculadas al recurso determinado.