REST Resource: advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations

Risorsa: YoutubeAssetAssociation

Un'associazione tra una risorsa e una risorsa di YouTube.

Rappresentazione JSON 
{
  "name": string,
  "youtubeAssetType": enum (YoutubeAssetType),
  "linkedYoutubeAsset": {
    object (LinkedYouTubeAsset)
  }
}
Campi
name

string

Identificatore. Il nome della risorsa dell'associazione.

Per le associazioni a livello di elemento pubblicitario: il pattern del nome è advertisers/{advertiserId}/lineItems/{lineItemId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations/{youtubeAssetAssociationId}.

Per le associazioni a livello di gruppo di annunci: il pattern del nome è advertisers/{advertiserId}/adGroups/{adGroupId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations/{youtubeAssetAssociationId}.

Per le associazioni YOUTUBE_ASSET_TYPE_LOCATION e YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION: youtubeAssetAssociationId è l'ID dell'insieme di asset collegato o 0 se locationMatchingType o affiliateLocationMatchingType è DISABLED.

Per le associazioni YOUTUBE_ASSET_TYPE_SITELINK: youtubeAssetAssociationId è l'ID dell'asset sitelink collegato.
youtubeAssetType

enum (YoutubeAssetType)

Obbligatorio. Il tipo di asset di YouTube associato alla risorsa.
linkedYoutubeAsset

object (LinkedYouTubeAsset)

Obbligatorio. L'asset di YouTube associato alla risorsa.

YoutubeAssetType

Possibili tipi di asset YouTube.

Questi asset mostreranno informazioni aggiuntive accanto agli annunci durante la pubblicazione.

Enum
YOUTUBE_ASSET_TYPE_UNSPECIFIED Il tipo di asset di YouTube non è specificato o è sconosciuto in questa versione.
YOUTUBE_ASSET_TYPE_LOCATION Asset posizione.
YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION Asset posizione dell'affiliato.

LinkedYouTubeAsset

Un asset di YouTube collegato a una risorsa in un YoutubeAssetAssociation.

Rappresentazione JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "locationAssetFilter": {
    object (LocationAssetFilter)
  },
  "affiliateLocationAssetFilter": {
    object (AffiliateLocationAssetFilter)
  },
  "sitelinkAsset": {
    object (SitelinkAsset)
  }
  // End of mutually exclusive fields.
}
Campi
L'asset di YouTube. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
locationAssetFilter

object (LocationAssetFilter)

Un filtro asset posizione.

Può essere impostato solo quando youtubeAssetType è YOUTUBE_ASSET_TYPE_LOCATION.
affiliateLocationAssetFilter

object (AffiliateLocationAssetFilter)

Un filtro per gli asset posizione dell'affiliato.

Può essere impostato solo quando youtubeAssetType è YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION.
Fine dei campi che si escludono a vicenda.

LocationAssetFilter

Un filtro degli asset che corrisponde agli asset posizione idonei alla pubblicazione.

Rappresentazione JSON 
{
  "locationMatchingType": enum (LocationMatchingType),
  "assetSetId": string,
  "locationMatchingFunction": {
    object (LocationMatchingFunction)
  }
}
Campi
locationMatchingType

enum (LocationMatchingType)

Obbligatorio. Il tipo di corrispondenza di questo filtro degli asset posizione.
assetSetId

string (int64 format)

Solo output. L'ID dell'insieme di asset che corrisponde agli asset posizione idonei alla pubblicazione.
locationMatchingFunction

object (LocationMatchingFunction)

Facoltativo. La funzione di corrispondenza che determina la corrispondenza tra il filtro degli asset posizione e gli asset posizione.

Questo campo è obbligatorio e può essere impostato solo se locationMatchingType è FILTER o SELECTED_ASSETS.

LocationMatchingType

Possibili tipi di corrispondenza che determinano quali asset di località sono idonei per la pubblicazione.

Enum
LOCATION_MATCHING_TYPE_UNSPECIFIED Il tipo di corrispondenza della località non è specificato o è sconosciuto in questa versione.
SELECT_ALL Tutti gli asset posizione disponibili sono idonei alla pubblicazione.
FILTER Possono essere pubblicati gli asset di località che corrispondono ai filtri per nome dell'attività e/o etichetta forniti.
SELECTED_ASSETS Possono essere pubblicati solo gli asset di località selezionati.
DISABLED Nessun asset posizione può essere pubblicato.

LocationMatchingFunction

La funzione di corrispondenza per un filtro degli asset posizione.

Rappresentazione JSON 
{
  "labels": [
    string
  ],
  "locationAssetIds": [
    string
  ],
  "business": string
}
Campi
labels[]

string

Facoltativo. Le etichette con cui trovare la corrispondenza.

Le etichette vengono combinate con l'operatore logico OR.

Questo campo è facoltativo e può essere impostato solo se locationMatchingType è FILTER.
locationAssetIds[]

string (int64 format)

Facoltativo. Gli ID asset posizione selezionati.

Questo campo è obbligatorio se locationMatchingType è SELECTED_ASSETS.
business

string

Facoltativo. Il nome dell'attività da abbinare.

Questo campo è facoltativo e può essere impostato solo se locationMatchingType è FILTER.

AffiliateLocationAssetFilter

Un filtro degli asset che corrisponde agli asset posizione dell'affiliato idonei alla pubblicazione.

Rappresentazione JSON 
{
  "affiliateLocationMatchingType": enum (AffiliateLocationMatchingType),
  "assetSetId": string,
  "affiliateLocationMatchingFunction": {
    object (AffiliateLocationMatchingFunction)
  }
}
Campi
affiliateLocationMatchingType

enum (AffiliateLocationMatchingType)

Obbligatorio. Il tipo di corrispondenza di questo filtro degli asset posizione dell'affiliato.
assetSetId

string (int64 format)

Solo output. L'ID dell'insieme di asset che corrisponde agli asset posizione dell'affiliato idonei alla pubblicazione.
affiliateLocationMatchingFunction

object (AffiliateLocationMatchingFunction)

Facoltativo. La funzione di corrispondenza che determina la corrispondenza tra il filtro degli asset posizione dell'affiliato e gli asset posizione dell'affiliato.

Questo campo è obbligatorio e può essere impostato solo se affiliateLocationMatchingType è SELECTED_CHAINS.

AffiliateLocationMatchingType

Possibili tipi di corrispondenza che determinano quali asset posizione dell'affiliato sono idonei per la pubblicazione.

Enum
AFFILIATE_LOCATION_MATCHING_TYPE_UNSPECIFIED Il tipo di corrispondenza della sede della società consociata non è specificato o è sconosciuto in questa versione.
SELECT_ALL Tutti gli asset posizione dell'affiliato disponibili sono idonei alla pubblicazione.
SELECTED_CHAINS Gli asset posizione dell'affiliato selezionati possono essere pubblicati.
DISABLED Non è possibile pubblicare asset posizione dell'affiliato.

AffiliateLocationMatchingFunction

La funzione di corrispondenza per un filtro dell'asset posizione dell'affiliato.

Rappresentazione JSON 
{
  "chains": [
    {
      object (AffiliateLocationChain)
    }
  ]
}
Campi
chains[]

object (AffiliateLocationChain)

Facoltativo. Gli ID delle catene di sedi della società consociata selezionate.

Questo campo è obbligatorio se affiliateLocationMatchingType è SELECTED_CHAINS.

AffiliateLocationChain

Una catena di località affiliate.

Rappresentazione JSON 
{
  "chainId": string
}
Campi
chainId

string (int64 format)

Obbligatorio. ID della catena di sedi affiliate.

SitelinkAsset

Un asset sitelink.

Rappresentazione JSON 
{
  "assetId": string
}
Campi
assetId

string (int64 format)

Obbligatorio. ID dell'asset sitelink.

Metodi

create

 Crea una nuova associazione tra la risorsa identificata e un asset di YouTube.

delete

 Elimina un'associazione esistente tra la risorsa identificata e una risorsa di YouTube.

list

 Elenca le associazioni di asset di YouTube collegate alla risorsa specificata.