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 du poste : 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 de composants associé, ou à 0 si locationMatchingType ou affiliateLocationMatchingType est défini sur 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 de composants 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 
{

  // 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.
}
Champs
Élément YouTube. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
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.
Fin des champs qui s'excluent mutuellement.

LocationAssetFilter

Filtre de composants qui correspond 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 de composants 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 pouvant être diffusés.

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 correspondant aux filtres de nom d'entreprise et/ou de 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és à faire correspondre.

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 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 à faire correspondre.

Ce champ est facultatif et ne peut être défini que si locationMatchingType est 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 défini sur 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 de 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 élément YouTube.

delete

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

list

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