REST Resource: advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations

Risorsa: YoutubeAssetAssociation

Un'associazione tra una risorsa e una risorsa 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 del set 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 YouTube associata alla risorsa.
linkedYoutubeAsset

object (LinkedYouTubeAsset)

Obbligatorio. La risorsa 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 asset 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 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:
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 di località.
assetSetId

string (int64 format)

Solo output. L'ID del set di asset che corrisponde agli asset di località idonei alla pubblicazione.
locationMatchingFunction

object (LocationMatchingFunction)

Facoltativo. La funzione di corrispondenza che determina la modalità di corrispondenza degli asset posizione del filtro.

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

LocationMatchingType

I possibili tipi di corrispondenza che determinano quali asset di località sono idonei alla 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 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. L'etichetta 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 del set di asset che corrisponde agli asset posizione dell'affiliato idonei alla pubblicazione.
affiliateLocationMatchingFunction

object (AffiliateLocationMatchingFunction)

Facoltativo. La funzione di corrispondenza che determina la modalità di corrispondenza del filtro degli 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 con corrispondenza per un filtro degli 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 YouTube.

delete

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

list

 Elenca le associazioni di asset YouTube collegate alla risorsa specificata.