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 risorsa di YouTube associata alla risorsa.
linkedYoutubeAsset

object (LinkedYouTubeAsset)

Obbligatorio. La risorsa di YouTube associata 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 risorsa 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

Una risorsa di YouTube collegata a una risorsa in un YoutubeAssetAssociation.

Rappresentazione 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.
}
Campi
Campo unione youtube_asset. La risorsa di YouTube. youtube_asset può essere solo uno dei seguenti tipi:
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.

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 alla pubblicazione.

Enum
LOCATION_MATCHING_TYPE_UNSPECIFIED Il tipo di corrispondenza della posizione 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 del nome dell'attività e/o dell'etichetta forniti.
SELECTED_ASSETS Possono essere pubblicati solo gli asset di località selezionati.
DISABLED Non è possibile pubblicare asset posizione.

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 eseguire 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 per la 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 in che modo il filtro degli asset posizione dell'affiliato corrisponde agli asset posizione dell'affiliato.

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

AffiliateLocationMatchingType

I possibili tipi di corrispondenza che determinano quali asset posizione dell'affiliato sono idonei alla pubblicazione.

Enum
AFFILIATE_LOCATION_MATCHING_TYPE_UNSPECIFIED Il tipo di corrispondenza delle località affiliate 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 Nessun asset posizione dell'affiliato può essere pubblicato.

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 catena delle sedi della società consociata selezionate.

Questo campo è obbligatorio se affiliateLocationMatchingType è SELECTED_CHAINS.

AffiliateLocationChain

Una catena di sedi 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 una risorsa di YouTube.

delete

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

list

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