AssetSet

Ensemble d'assets représentant un ensemble d'assets. Utilisez AssetSetAsset pour associer un asset à l'ensemble d'assets.

Représentation JSON
{
  "id": string,
  "resourceName": string,
  "name": string,
  "type": enum (AssetSetType),
  "status": enum (AssetSetStatus),
  "merchantCenterFeed": {
    object (MerchantCenterFeed)
  },
  "locationGroupParentAssetSetId": string,
  "hotelPropertyData": {
    object (HotelPropertyData)
  },

  // Union field asset_set_source can be only one of the following:
  "locationSet": {
    object (LocationSet)
  },
  "businessProfileLocationGroup": {
    object (BusinessProfileLocationGroup)
  },
  "chainLocationGroup": {
    object (ChainLocationGroup)
  }
  // End of list of possible types for union field asset_set_source.
}
Champs
id

string (int64 format)

Uniquement en sortie. ID de l'ensemble d'éléments.

resourceName

string

Immuable. Nom de ressource de l'ensemble d'éléments. Les noms de ressources de l'ensemble d'éléments se présentent sous la forme suivante:

customers/{customerId}/assetSets/{asset_set_id}

name

string

Obligatoire. Nom de l'ensemble d'éléments. Obligatoire. Il doit avoir une longueur minimale de 1 et une longueur maximale de 128.

type

enum (AssetSetType)

Obligatoire. Immuable. Type de l'ensemble d'assets. Obligatoire.

status

enum (AssetSetStatus)

Uniquement en sortie. État de l'ensemble d'assets. Lecture seule.

merchantCenterFeed

object (MerchantCenterFeed)

ID du marchand et libellé de flux de Google Merchant Center.

locationGroupParentAssetSetId

string (int64 format)

Immuable. ID de l'ensemble d'éléments parent pour l'ensemble d'éléments d'où proviennent les éléments de cet ensemble. Par exemple, l'ID AssetSet de l'emplacement au niveau de la synchronisation d'où proviennent les éléments de l'ensemble d'éléments "LocationGroup". Ce champ est obligatoire et ne s'applique qu'à l'ensemble d'éléments AssetSet de type groupe d'établissements.

hotelPropertyData

object (HotelPropertyData)

Uniquement en sortie. Dans les campagnes Performance Max pour les objectifs de voyage avec une association de compte Hotel Center. Lecture seule.

Champ d'union asset_set_source. Données d'ensemble d'assets propres à chaque type d'ensemble d'assets. Tous les types ne comportent pas de données spécifiques. asset_set_source ne peut être qu'un des éléments suivants :
locationSet

object (LocationSet)

Données de l'ensemble de composants Lieu. Il sera utilisé pour définir l'emplacement au niveau de la synchronisation. Cet attribut ne peut être défini que si AssetSet est de type LOCATION_SYNC.

businessProfileLocationGroup

object (BusinessProfileLocationGroup)

Données de l'ensemble de composants du groupe de zones géographiques des fiches d'établissement.

chainLocationGroup

object (ChainLocationGroup)

Représente les informations sur un groupe d'établissements dynamiques de type "Chaîne". Ne s'applique que si le type d'AssetSet au niveau de la synchronisation est LOCATION_SYNC et la source de synchronisation est chaîne.

AssetSetStatus

États possibles d'un ensemble d'assets.

Enums
UNSPECIFIED L'état n'a pas été spécifié.
UNKNOWN La valeur reçue n'est pas connue dans cette version. Cette valeur ne peut être fournie qu'à partir d'une réponse.
ENABLED L'ensemble de composants est activé.
REMOVED L'ensemble d'assets est supprimé.

MerchantCenterFeed

ID du marchand et libellé de flux de Google Merchant Center.

Représentation JSON
{
  "merchantId": string,
  "feedLabel": string
}
Champs
merchantId

string (int64 format)

Obligatoire. Référence marchand dans Google Merchant Center

feedLabel

string

Facultatif. Libellé du flux de Google Merchant Center.

HotelPropertyData

Dans les campagnes Performance Max pour les objectifs de voyage avec une association de compte Hotel Center. Lecture seule.

Représentation JSON
{
  "hotelCenterId": string,
  "partnerName": string
}
Champs
hotelCenterId

string (int64 format)

Uniquement en sortie. ID Hotel Center du partenaire.

partnerName

string

Uniquement en sortie. Nom de l'hôtel partenaire.

LocationSet

Données liées à l'ensemble de zones géographiques. Vous devez indiquer l'une des données de la fiche d'établissement Google (anciennement Google My Business), les données de la chaîne et les données de localisation sur la carte.

Représentation JSON
{
  "locationOwnershipType": enum (LocationOwnershipType),

  // Union field source can be only one of the following:
  "businessProfileLocationSet": {
    object (BusinessProfileLocationSet)
  },
  "chainLocationSet": {
    object (ChainSet)
  },
  "mapsLocationSet": {
    object (MapsLocationSet)
  }
  // End of list of possible types for union field source.
}
Champs
locationOwnershipType

enum (LocationOwnershipType)

Obligatoire. Immuable. Type de propriété de l'établissement (établissement propriétaire ou lieu affilié)

Champ d'union source. Données de localisation propres à chaque source de synchronisation. source ne peut être qu'un des éléments suivants :
businessProfileLocationSet

object (BusinessProfileLocationSet)

Données utilisées pour configurer un ensemble d'établissements généré à partir d'établissements de la fiche d'établissement Google.

chainLocationSet

object (ChainSet)

Données utilisées pour configurer un établissement dans un ensemble de chaînes contenant les chaînes spécifiées.

mapsLocationSet

object (MapsLocationSet)

Défini uniquement si les établissements sont synchronisés en fonction des lieux sélectionnés sur la carte

BusinessProfileLocationSet

Données utilisées pour configurer un ensemble d'établissements généré à partir d'établissements de la fiche d'établissement Google. S'ils sont spécifiés, les différents types de filtres sont reliés par l'opérateur ET.

Représentation JSON
{
  "httpAuthorizationToken": string,
  "emailAddress": string,
  "businessNameFilter": string,
  "labelFilters": [
    string
  ],
  "listingIdFilters": [
    string
  ],
  "businessAccountId": string
}
Champs
httpAuthorizationToken

string

Obligatoire. Immuable. Jeton d'autorisation HTTP utilisé pour obtenir l'autorisation.

emailAddress

string

Obligatoire. Immuable. Adresse e-mail d'un compte de fiche d'établissement Google ou adresse e-mail d'un administrateur du compte de fiches d'établissement Google.

businessNameFilter

string

Permet de filtrer les fiches d'établissement Google par nom d'entreprise. Si businessNameFilter est défini, seules les fiches associées à un nom d'entreprise correspondant peuvent être synchronisées avec des composants.

labelFilters[]

string

Permet de filtrer les fiches d'établissement Google par libellé. Si des entrées existent dans labelFilters, seules les fiches comportant l'un des libellés définis peuvent être synchronisées avec les éléments. Si aucune entrée n'existe dans labelFilters, toutes les fiches peuvent être synchronisées. Les filtres de libellé sont reliés par l'opérateur OR.

listingIdFilters[]

string (int64 format)

Permet de filtrer les fiches d'établissement Google par ID de fiche. Si des entrées existent dans ListingIdFilters, seules les fiches spécifiées par les filtres sont candidates pour être synchronisées avec les Assets. Si aucune entrée n'existe dans listingIdFilters, toutes les fiches peuvent être synchronisées. Les filtres d'ID de fiche sont reliés par l'opérateur OU.

businessAccountId

string

Immuable. Numéro de compte de l'entreprise gérée dont les établissements doivent être utilisés. Si ce champ n'est pas défini, tous les établissements auxquels l'utilisateur peut accéder (spécifiés par l'adresse e-mail) sont utilisés.

ChainSet

Données utilisées pour configurer un ensemble d'emplacements contenant les chaînes spécifiées.

Représentation JSON
{
  "relationshipType": enum (ChainRelationshipType),
  "chains": [
    {
      object (ChainFilter)
    }
  ]
}
Champs
relationshipType

enum (ChainRelationshipType)

Obligatoire. Immuable. Type de relation des chaînes spécifiées avec cet annonceur.

chains[]

object (ChainFilter)

Obligatoire. Liste de filtres au niveau de la chaîne ; tous les filtres sont liés par l'opérateur OU.

ChainRelationshipType

Types de relation possibles.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
AUTO_DEALERS votre relation avec un concessionnaire automobile.
GENERAL_RETAILERS Relation générale avec le marchand.

ChainFilter

Un filtre au niveau de la chaîne en fonction de l'établissement dans un ensemble d'éléments de flux. La logique de filtrage entre tous les champs est ET.

Représentation JSON
{
  "chainId": string,
  "locationAttributes": [
    string
  ]
}
Champs
chainId

string (int64 format)

Obligatoire. Permet de filtrer les établissements d'une chaîne par identifiant. Seuls les établissements appartenant à la chaîne spécifiée figureront dans l'ensemble d'assets.

locationAttributes[]

string

Permet de filtrer les établissements d'une chaîne en fonction de leurs attributs. Seules les chaînes d'établissements qui appartiennent à tous les attributs spécifiés figureront dans l'ensemble d'assets. Si ce champ est vide, cela signifie qu'il n'est pas filtré.

MapsLocationSet

Wrapper pour données de synchronisation de plusieurs lieux dans Maps

Représentation JSON
{
  "mapsLocations": [
    {
      object (MapsLocationInfo)
    }
  ]
}
Champs
mapsLocations[]

object (MapsLocationInfo)

Obligatoire. Liste des informations de localisation Google Maps que l'utilisateur a synchronisées manuellement.

MapsLocationInfo

Wrapper pour les ID de lieu

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

string

ID de l'emplacement sur Maps.

BusinessProfileLocationGroup

Informations sur un groupe d'établissements dynamiques de fiche d'établissement. Ne s'applique que si le type d'AssetSet au niveau de la synchronisation est LOCATION_SYNC et la source de synchronisation est "Fiche d'établissement".

Représentation JSON
{
  "dynamicBusinessProfileLocationGroupFilter": {
    object (DynamicBusinessProfileLocationGroupFilter)
  }
}
Champs
dynamicBusinessProfileLocationGroupFilter

object (DynamicBusinessProfileLocationGroupFilter)

Filtrez les données pour n'afficher que les ensembles d'établissements dynamiques.

DynamicBusinessProfileLocationGroupFilter

Représente un filtre sur les établissements de la fiche d'un ensemble de composants. Si plusieurs filtres sont fournis, ils sont reliés par l'opérateur ET.

Représentation JSON
{
  "labelFilters": [
    string
  ],
  "listingIdFilters": [
    string
  ],
  "businessNameFilter": {
    object (BusinessProfileBusinessNameFilter)
  }
}
Champs
labelFilters[]

string

Permet de filtrer les établissements de la fiche par libellé. Seuls les établissements associés à l'un des libellés répertoriés figureront dans l'ensemble d'assets. Les filtres de libellé sont reliés par l'opérateur OR.

listingIdFilters[]

string (int64 format)

Permet de filtrer les établissements des fiches en fonction des ID de fiche.

businessNameFilter

object (BusinessProfileBusinessNameFilter)

Permet de filtrer les établissements de la fiche par nom.

BusinessProfileBusinessNameFilter

Filtre par nom d'entreprise pour le groupe de zones géographiques des fiches d'établissement.

Représentation JSON
{
  "businessName": string,
  "filterType": enum (LocationStringFilterType)
}
Champs
businessName

string

Chaîne indiquant le nom de l'entreprise à utiliser pour le filtrage.

filterType

enum (LocationStringFilterType)

Type de correspondance de chaîne à utiliser lors du filtrage avec businessName.

LocationStringFilterType

Types possibles d'un filtre de chaîne d'emplacement.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
EXACT Le filtre utilisera une correspondance de chaîne exacte.

ChainLocationGroup

Représente les informations sur un groupe d'établissements dynamiques de type "Chaîne". Ne s'applique que si le type d'AssetSet au niveau de la synchronisation est LOCATION_SYNC et la source de synchronisation est chaîne.

Représentation JSON
{
  "dynamicChainLocationGroupFilters": [
    {
      object (ChainFilter)
    }
  ]
}
Champs
dynamicChainLocationGroupFilters[]

object (ChainFilter)

Permet de filtrer les établissements d'une chaîne par ID de chaîne. Seuls les établissements appartenant aux chaînes spécifiées figureront dans l'ensemble d'assets.