AssetSet

Ensemble d'éléments représentant un ensemble d'éléments. Utilisez AssetSetAsset pour associer un élément à l'ensemble de composants.

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 de composants.

resourceName

string

Immuable. Nom de ressource de l'ensemble de composants. Les noms de ressources de l'ensemble d'éléments se présentent comme suit:

customers/{customerId}/assetSets/{asset_set_id}

name

string

Obligatoire. Nom de l'ensemble de composants. Obligatoire. Il doit comporter entre 1 et 128 caractères.

type

enum (AssetSetType)

Obligatoire. Immuable. Type de l'ensemble de composants. Obligatoire.

status

enum (AssetSetStatus)

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

merchantCenterFeed

object (MerchantCenterFeed)

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

locationGroupParentAssetSetId

string (int64 format)

Immuable. ID de l'ensemble d'éléments parent de 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'élément AssetSet de type "Groupe d'établissements".

hotelPropertyData

object (HotelPropertyData)

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

Champ d'union asset_set_source. Données d'ensemble de composants propres à chaque type d'ensemble de composants. 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 l'emplacement défini au niveau de la synchronisation. Cette valeur ne peut être définie que si le type d'AssetSet est LOCATION_SYNC.

businessProfileLocationGroup

object (BusinessProfileLocationGroup)

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

chainLocationGroup

object (ChainLocationGroup)

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

AssetSetStatus

États possibles d'un ensemble de composants.

Enums
UNSPECIFIED L'état n'a pas été spécifié.
UNKNOWN La valeur reçue n'est pas connue dans cette version. Il s'agit d'une valeur de réponse uniquement.
ENABLED L'ensemble de composants est activé.
REMOVED L'ensemble de composants est supprimé.

MerchantCenterFeed

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

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

string (int64 format)

Obligatoire. Référence marchand issue de Google Merchant Center

feedLabel

string

Facultatif. Libellé du flux issu de Google Merchant Center.

HotelPropertyData

Pour les campagnes Performance Max pour les objectifs de voyage avec une association à un 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 une 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 des fiches d'établissement Google.

chainLocationSet

object (ChainSet)

Données utilisées pour configurer un établissement sur 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 positions sélectionnées sur la carte

BusinessProfileLocationSet

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

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 dont le nom correspond à l'entreprise peuvent être synchronisées avec les composants.

labelFilters[]

string

Permet de filtrer les fiches d'établissement Google par libellé. Si des entrées existent dans labelFilters, seules les fiches associées à l'un des libellés définis peuvent être synchronisées avec des éléments. Si aucune entrée n'existe dans labelFilters, toutes les fiches peuvent être synchronisées. Les filtres de libellés 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 peuvent être synchronisées avec des éléments. 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 a accès (spécifiés par emailAddress) 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 entre les chaînes spécifiées et cet annonceur.

chains[]

object (ChainFilter)

Obligatoire. Liste de filtres au niveau de la chaîne (tous les filtres sont regroupés par l'opérateur OR).

ChainRelationshipType

Types possibles d'une relation.

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

ChainFilter

Un filtre au niveau de la chaîne pour la zone géographique dans un ensemble d'éléments de flux. La logique de filtrage pour 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 ID de chaîne. Seuls les établissements appartenant à la chaîne spécifiée figureront dans l'ensemble de composants.

locationAttributes[]

string

Permet de filtrer les établissements d'une chaîne par attributs de zone géographique. Seuls les établissements de chaînes appartenant à tous les attributs spécifiés figureront dans l'ensemble de composants. Si ce champ est vide, cela signifie qu'il n'est pas filtré.

MapsLocationSet

Enveloppe pour les données de synchronisation d'emplacements sur plusieurs cartes

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

object (MapsLocationInfo)

Obligatoire. Liste des informations de localisation sur les cartes que l'utilisateur a synchronisées manuellement.

MapsLocationInfo

Wrapper pour les ID de lieu

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

string

ID de lieu de l'emplacement sur Maps.

BusinessProfileLocationGroup

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

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

object (DynamicBusinessProfileLocationGroupFilter)

Filtrez sur les ensembles de zones géographiques des fiches d'établissement dynamiques.

DynamicBusinessProfileLocationGroupFilter

Représente un filtre sur les établissements de fiches 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és sont reliés par l'opérateur OR.

listingIdFilters[]

string (int64 format)

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

businessNameFilter

object (BusinessProfileBusinessNameFilter)

Permet de filtrer les établissements de la fiche par nom d'entreprise.

BusinessProfileBusinessNameFilter

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

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

string

Chaîne de nom d'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 la correspondance de chaîne exacte.

ChainLocationGroup

Représente les informations sur un groupe d'établissements dynamiques de chaîne. Ne s'applique que si le type d'AssetSet du niveau de synchronisation est LOCATION_SYNC et la source de synchronisation est une 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 de composants.