REST Resource: advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations

Recurso: YoutubeAssetAssociation

Uma associação entre um recurso e um recurso do YouTube.

Representação JSON 
{
  "name": string,
  "youtubeAssetType": enum (YoutubeAssetType),
  "linkedYoutubeAsset": {
    object (LinkedYouTubeAsset)
  }
}
Campos
name

string

Identificador. O nome do recurso da associação.

Para associações no nível do item de linha, o padrão de nome é advertisers/{advertiserId}/lineItems/{lineItemId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations/{youtubeAssetAssociationId}.

Para associações no nível do grupo de anúncios: o padrão de nome é advertisers/{advertiserId}/adGroups/{adGroupId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations/{youtubeAssetAssociationId}.

Para associações YOUTUBE_ASSET_TYPE_LOCATION e YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION: youtubeAssetAssociationId é o ID do conjunto de recursos vinculado ou 0 se o locationMatchingType ou affiliateLocationMatchingType for DISABLED.

Para associações YOUTUBE_ASSET_TYPE_SITELINK: youtubeAssetAssociationId é o ID do recurso de sitelink vinculado.
youtubeAssetType

enum (YoutubeAssetType)

Obrigatório. O tipo de recurso do YouTube associado ao recurso.
linkedYoutubeAsset

object (LinkedYouTubeAsset)

Obrigatório. O recurso do YouTube associado ao recurso.

YoutubeAssetType

Tipos possíveis de recursos do YouTube.

Esses recursos vão mostrar informações adicionais ao lado dos anúncios durante a veiculação.

Tipos enumerados
YOUTUBE_ASSET_TYPE_UNSPECIFIED O tipo de recurso do YouTube não foi especificado ou é desconhecido nesta versão.
YOUTUBE_ASSET_TYPE_LOCATION Recurso de local.
YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION Recurso de local de afiliado.

LinkedYouTubeAsset

Um recurso do YouTube vinculado a um recurso em um YoutubeAssetAssociation.

Representação 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ão youtube_asset. O recurso do YouTube. youtube_asset pode ser apenas de um dos tipos a seguir:
locationAssetFilter

object (LocationAssetFilter)

Um filtro de recurso de local.

Isso só pode ser definido quando youtubeAssetType é YOUTUBE_ASSET_TYPE_LOCATION.
affiliateLocationAssetFilter

object (AffiliateLocationAssetFilter)

Um filtro de recurso de local de afiliado.

Isso só pode ser definido quando youtubeAssetType é YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION.

LocationAssetFilter

Um filtro de recursos que corresponde aos recursos de local qualificados para veiculação.

Representação JSON 
{
  "locationMatchingType": enum (LocationMatchingType),
  "assetSetId": string,
  "locationMatchingFunction": {
    object (LocationMatchingFunction)
  }
}
Campos
locationMatchingType

enum (LocationMatchingType)

Obrigatório. O tipo de correspondência deste filtro de recurso de local.
assetSetId

string (int64 format)

Apenas saída. O ID do conjunto de recursos que corresponde aos recursos de local qualificados para veiculação.
locationMatchingFunction

object (LocationMatchingFunction)

Opcional. A função correspondente que determina como o filtro de recurso de local corresponde aos recursos de local.

Esse campo é obrigatório e só pode ser definido se locationMatchingType for FILTER ou SELECTED_ASSETS.

LocationMatchingType

Possíveis tipos de correspondência que decidem quais recursos de local estão qualificados para veiculação.

Tipos enumerados
LOCATION_MATCHING_TYPE_UNSPECIFIED O tipo de correspondência de local não foi especificado ou é desconhecido nesta versão.
SELECT_ALL Todos os recursos de local disponíveis estão qualificados para veiculação.
FILTER Os recursos de local que correspondem a um nome da empresa e/ou filtros de rótulo fornecidos podem ser veiculados.
SELECTED_ASSETS Somente os recursos de local selecionados podem ser veiculados.
DISABLED Nenhum recurso de local pode ser veiculado.

LocationMatchingFunction

A função de correspondência para um filtro de recurso de local.

Representação JSON 
{
  "labels": [
    string
  ],
  "locationAssetIds": [
    string
  ],
  "business": string
}
Campos
labels[]

string

Opcional. O marcador a ser correspondido.

Os rótulos são combinados com um OR lógico.

Este campo é opcional e só pode ser definido se locationMatchingType for FILTER.
locationAssetIds[]

string (int64 format)

Opcional. Os IDs dos recursos de local selecionados.

Este campo é obrigatório se locationMatchingType for SELECTED_ASSETS.
business

string

Opcional. O nome da empresa a ser correspondido.

Este campo é opcional e só pode ser definido se locationMatchingType for FILTER.

AffiliateLocationAssetFilter

Um filtro de recurso que corresponde aos recursos de local de afiliado qualificados para veiculação.

Representação JSON 
{
  "affiliateLocationMatchingType": enum (AffiliateLocationMatchingType),
  "assetSetId": string,
  "affiliateLocationMatchingFunction": {
    object (AffiliateLocationMatchingFunction)
  }
}
Campos
affiliateLocationMatchingType

enum (AffiliateLocationMatchingType)

Obrigatório. O tipo de correspondência deste filtro de recurso de local de afiliado.
assetSetId

string (int64 format)

Apenas saída. O ID do conjunto de recursos que corresponde aos recursos de local de afiliado qualificados para veiculação.
affiliateLocationMatchingFunction

object (AffiliateLocationMatchingFunction)

Opcional. A função de correspondência que determina como o filtro de recurso de local de afiliado corresponde a recursos de local de afiliado.

Esse campo é obrigatório e só pode ser definido se affiliateLocationMatchingType for SELECTED_CHAINS.

AffiliateLocationMatchingType

Possíveis tipos de correspondência que decidem quais recursos de local de afiliado estão qualificados para veiculação.

Tipos enumerados
AFFILIATE_LOCATION_MATCHING_TYPE_UNSPECIFIED O tipo de correspondência de local de afiliado não foi especificado ou é desconhecido nesta versão.
SELECT_ALL Todos os recursos de local de afiliado disponíveis estão qualificados para veiculação.
SELECTED_CHAINS Os recursos de local de afiliado selecionados podem ser veiculados.
DISABLED Nenhum recurso de local de afiliado pode ser veiculado.

AffiliateLocationMatchingFunction

A função de correspondência para um filtro de recurso de local de afiliado.

Representação JSON 
{
  "chains": [
    {
      object (AffiliateLocationChain)
    }
  ]
}
Campos
chains[]

object (AffiliateLocationChain)

Opcional. Os IDs da rede de locais de afiliados selecionados.

Este campo é obrigatório se affiliateLocationMatchingType for SELECTED_CHAINS.

AffiliateLocationChain

Uma rede de locais de afiliados.

Representação JSON 
{
  "chainId": string
}
Campos
chainId

string (int64 format)

Obrigatório. ID da rede de locais afiliados.

SitelinkAsset

Um recurso de sitelink.

Representação JSON 
{
  "assetId": string
}
Campos
assetId

string (int64 format)

Obrigatório. ID do recurso de sitelink.

Métodos

create

 Cria uma nova associação entre o recurso identificado e um recurso do YouTube.

delete

 Exclui uma associação entre o recurso identificado e um recurso do YouTube.

list

 Lista as associações de recursos do YouTube vinculadas ao recurso especificado.