REST Resource: advertisers.adGroups.youtubeAssetTypes.youtubeAssetAssociations

Ressource : YoutubeAssetAssociation

Association entre une ressource et un élément YouTube.

Représentation JSON 
{
  "name": string,
  "youtubeAssetType": enum (YoutubeAssetType),
  "linkedYoutubeAsset": {
    object (LinkedYouTubeAsset)
  }
}
Champs
name

string

Identifiant. Nom de ressource de l'association.

Pour les associations au niveau de l'article : le modèle de nom est advertisers/{advertiserId}/lineItems/{lineItemId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations/{youtubeAssetAssociationId}.

Pour les associations au niveau du groupe d'annonces : le modèle de nom est advertisers/{advertiserId}/adGroups/{adGroupId}/youtubeAssetTypes/{youtubeAssetType}/youtubeAssetAssociations/{youtubeAssetAssociationId}.

Pour les associations YOUTUBE_ASSET_TYPE_LOCATION et YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION : youtubeAssetAssociationId correspond à l'ID de l'ensemble d'assets associé, ou à 0 si locationMatchingType ou affiliateLocationMatchingType est DISABLED.

Pour les associations YOUTUBE_ASSET_TYPE_SITELINK : youtubeAssetAssociationId correspond à l'ID du composant Lien annexe associé.
youtubeAssetType

enum (YoutubeAssetType)

Obligatoire. Type d'élément YouTube associé à la ressource.
linkedYoutubeAsset

object (LinkedYouTubeAsset)

Obligatoire. Élément YouTube associé à la ressource.

YoutubeAssetType

Types d'assets YouTube possibles.

Ces composants affichent des informations supplémentaires à côté des annonces lors de leur diffusion.

Enums
YOUTUBE_ASSET_TYPE_UNSPECIFIED Le type d'élément YouTube n'est pas spécifié ou est inconnu dans cette version.
YOUTUBE_ASSET_TYPE_LOCATION Composant Lieu.
YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION Composant Lieu affilié.

LinkedYouTubeAsset

Élément YouTube associé à une ressource dans un YoutubeAssetAssociation.

Représentation 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.
}
Champs
Champ d'union youtube_asset. Élément YouTube. youtube_asset ne peut être qu'un des éléments suivants :
locationAssetFilter

object (LocationAssetFilter)

Filtre de composant Lieu.

Ce paramètre ne peut être défini que lorsque youtubeAssetType est YOUTUBE_ASSET_TYPE_LOCATION.
affiliateLocationAssetFilter

object (AffiliateLocationAssetFilter)

Filtre de composant Lieu affilié.

Ce paramètre ne peut être défini que lorsque youtubeAssetType est YOUTUBE_ASSET_TYPE_AFFILIATE_LOCATION.

LocationAssetFilter

Filtre de composants correspondant aux composants Lieu éligibles à la diffusion.

Représentation JSON 
{
  "locationMatchingType": enum (LocationMatchingType),
  "assetSetId": string,
  "locationMatchingFunction": {
    object (LocationMatchingFunction)
  }
}
Champs
locationMatchingType

enum (LocationMatchingType)

Obligatoire. Type de correspondance de ce filtre de composant Lieu.
assetSetId

string (int64 format)

Uniquement en sortie. ID de l'ensemble d'assets correspondant aux composants Lieu éligibles à la diffusion.
locationMatchingFunction

object (LocationMatchingFunction)

Facultatif. Fonction de correspondance qui détermine comment le filtre de composants Lieu correspond aux composants Lieu.

Ce champ est obligatoire et ne peut être défini que si locationMatchingType est FILTER ou SELECTED_ASSETS.

LocationMatchingType

Types de correspondance possibles qui déterminent les composants Lieu éligibles à la diffusion.

Enums
LOCATION_MATCHING_TYPE_UNSPECIFIED Le type de correspondance de lieu n'est pas spécifié ou est inconnu dans cette version.
SELECT_ALL Tous les composants Lieu disponibles peuvent être diffusés.
FILTER Les composants Lieu qui correspondent aux filtres par nom d'entreprise et/ou par libellé fournis peuvent être diffusés.
SELECTED_ASSETS Seuls les composants Lieu sélectionnés peuvent être diffusés.
DISABLED Aucun composant Lieu ne peut être diffusé.

LocationMatchingFunction

Fonction de correspondance pour un filtre de composants Lieu.

Représentation JSON 
{
  "labels": [
    string
  ],
  "locationAssetIds": [
    string
  ],
  "business": string
}
Champs
labels[]

string

Facultatif. Libellé à mettre en correspondance.

Les libellés sont combinés de manière logique avec l'opérateur OR.

Ce champ est facultatif et ne peut être défini que si locationMatchingType est défini sur FILTER.
locationAssetIds[]

string (int64 format)

Facultatif. ID des composants Lieu sélectionnés.

Ce champ est obligatoire si locationMatchingType est défini sur SELECTED_ASSETS.
business

string

Facultatif. Nom de l'établissement à associer.

Ce champ est facultatif et ne peut être défini que si locationMatchingType est défini sur FILTER.

AffiliateLocationAssetFilter

Filtre de composants qui correspond aux composants Lieu affilié éligibles à la diffusion.

Représentation JSON 
{
  "affiliateLocationMatchingType": enum (AffiliateLocationMatchingType),
  "assetSetId": string,
  "affiliateLocationMatchingFunction": {
    object (AffiliateLocationMatchingFunction)
  }
}
Champs
affiliateLocationMatchingType

enum (AffiliateLocationMatchingType)

Obligatoire. Type de correspondance de ce filtre de composant Lieu affilié.
assetSetId

string (int64 format)

Uniquement en sortie. ID de l'ensemble d'assets correspondant aux composants Lieu affilié éligibles à la diffusion.
affiliateLocationMatchingFunction

object (AffiliateLocationMatchingFunction)

Facultatif. Fonction de correspondance qui détermine comment le filtre de composants Lieu affilié correspond aux composants Lieu affilié.

Ce champ est obligatoire et ne peut être défini que si affiliateLocationMatchingType est SELECTED_CHAINS.

AffiliateLocationMatchingType

Types de correspondance possibles qui déterminent les composants Lieu affilié éligibles à la diffusion.

Enums
AFFILIATE_LOCATION_MATCHING_TYPE_UNSPECIFIED Le type de correspondance du lieu affilié n'est pas spécifié ou est inconnu dans cette version.
SELECT_ALL Tous les composants Lieu affilié disponibles peuvent être diffusés.
SELECTED_CHAINS Les composants Lieu affilié sélectionnés peuvent être diffusés.
DISABLED Aucun composant Lieu affilié ne peut être diffusé.

AffiliateLocationMatchingFunction

Fonction de correspondance pour un filtre de composant Lieu affilié.

Représentation JSON 
{
  "chains": [
    {
      object (AffiliateLocationChain)
    }
  ]
}
Champs
chains[]

object (AffiliateLocationChain)

Facultatif. ID des chaînes de lieux affiliés sélectionnés.

Ce champ est obligatoire si affiliateLocationMatchingType est défini sur SELECTED_CHAINS.

AffiliateLocationChain

Chaîne de lieux affiliés.

Représentation JSON 
{
  "chainId": string
}
Champs
chainId

string (int64 format)

Obligatoire. ID de la chaîne d'établissements affiliés.

SitelinkAsset

Composant Lien annexe.

Représentation JSON 
{
  "assetId": string
}
Champs
assetId

string (int64 format)

Obligatoire. ID du composant Lien annexe.

Méthodes

create

 Crée une association entre la ressource identifiée et un asset YouTube.

delete

 Supprime une association existante entre la ressource identifiée et un asset YouTube.

list

 Liste les associations d'éléments YouTube liées à la ressource donnée.