AssetSet

Ensemble d'assets représentant une collection d'assets. Utilisez AssetSetAsset pour associer un élément à l'ensemble d'éléments.

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 la ressource de l'ensemble d'assets. Les noms de ressources d'ensemble d'assets ont la forme suivante:

customers/{customerId}/assetSets/{asset_set_id}

name

string

Obligatoire. Nom de l'ensemble d'assets. Obligatoire. Il doit comporter au moins un caractère et au maximum 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 d'assets. Lecture seule.

merchantCenterFeed

object (MerchantCenterFeed)

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

locationGroupParentAssetSetId

string (int64 format)

Immuable. ID de l'ensemble de composants parent de l'ensemble de composants dont proviennent les éléments de cet ensemble de composants. Par exemple: l'ID du composant AssetSet de lieu au niveau de la synchronisation d'où proviennent les éléments du composant AssetSet LocationGroup. Ce champ est obligatoire et ne s'applique qu'aux AssetSet de type "Groupe d'établissements".

hotelPropertyData

object (HotelPropertyData)

Uniquement en sortie. Pour les campagnes Performance Max pour les objectifs de voyage associées à un compte Hotel Center. Lecture seule.

Champ d'union asset_set_source. Données d'ensemble de composants spécifiques à chaque type d'ensemble de composants. Tous les types ne disposent 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 la position au niveau de la synchronisation. Ce paramètre ne peut être défini que si le type de l'AssetSet est LOCATION_SYNC.

businessProfileLocationGroup

object (BusinessProfileLocationGroup)

Données du groupe de composants Lieu de la fiche d'établissement.

chainLocationGroup

object (ChainLocationGroup)

Représente des informations sur un groupe d'établissements dynamiques d'une chaîne. Ne s'applique que si le type de l'AssetSet de niveau de synchronisation est LOCATION_SYNC et que la source de synchronisation est une 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. Il s'agit d'une valeur réservée aux réponses.
ENABLED L'ensemble d'assets est activé.
REMOVED L'ensemble d'assets est supprimé.

MerchantCenterFeed

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

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

string (int64 format)

Obligatoire. ID du marchand depuis Google Merchant Center

feedLabel

string

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

HotelPropertyData

Pour les campagnes Performance Max pour les objectifs de voyage associées à 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'emplacement défini. Vous devez spécifier l'une des données de la fiche d'établissement Google (anciennement Google My Business), des données de la chaîne ou des données de l'emplacement 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 droits détenus sur le lieu (lieu détenu ou lieu affilié)

Champ d'union source. Données de localisation spécifiques à 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 de zones géographiques à partir des établissements issus des fiches d'établissement Google.

chainLocationSet

object (ChainSet)

Données utilisées pour configurer un emplacement dans un ensemble de chaînes renseigné avec les chaînes spécifiées.

mapsLocationSet

object (MapsLocationSet)

Ne doit être défini que si les lieux sont synchronisés en fonction des lieux Maps sélectionnés

BusinessProfileLocationSet

Données utilisées pour configurer un ensemble de zones géographiques à partir des établissements issus des fiches d'établissement Google. Si plusieurs types de filtres sont spécifiés, ils 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 d'un gestionnaire de ce compte.

businessNameFilter

string

Permet de filtrer les fiches d'établissement Google par nom de l'établissement. Si businessNameFilter est défini, seules les fiches dont le nom d'entreprise correspond peuvent être synchronisées avec les composants.

labelFilters[]

string

Permet de filtrer les fiches d'établissement Google par libellé. Si des entrées figurent dans labelFilters, seules les fiches auxquelles l'un des libellés est appliqué peuvent être synchronisées dans Assets. Si aucune entrée n'existe dans labelFilters, toutes les fiches peuvent être synchronisées. Les filtres par libellé sont reliés par un opérateur OU.

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 dans Assets. Si aucune entrée n'existe dans listingIdFilters, toutes les fiches peuvent être synchronisées. Les filtres par ID de fiche sont reliés par un opérateur OU.

businessAccountId

string

Immuable. ID du compte de l'établissement géré dont les établissements doivent être utilisés. Si ce champ n'est pas défini, toutes les entreprises auxquelles l'utilisateur a accès (spécifiées par l'adresse e-mail) sont utilisées.

ChainSet

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

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

enum (ChainRelationshipType)

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

chains[]

object (ChainFilter)

Obligatoire. Liste de filtres au niveau de la chaîne. Tous les filtres sont reliés par un opérateur OU.

ChainRelationshipType

Types de relations possibles.

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

ChainFilter

Un filtre au niveau de la chaîne sur l'emplacement dans un ensemble d'éléments de flux. La logique de filtrage entre tous les champs est AND.

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 emplacements de la chaîne spécifiée seront inclus dans l'ensemble d'assets.

locationAttributes[]

string

Permet de filtrer les établissements d'une chaîne en fonction de leurs attributs. Seuls les établissements de la chaîne appartenant à tous les attributs spécifiés seront inclus dans l'ensemble d'assets. Si ce champ est vide, cela signifie qu'aucun filtrage n'est appliqué.

MapsLocationSet

Wrapper pour plusieurs données de synchronisation de la position Maps

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

object (MapsLocationInfo)

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

MapsLocationInfo

Wrapper pour les ID de lieu

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

string

ID du lieu sur Maps.

BusinessProfileLocationGroup

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

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

object (DynamicBusinessProfileLocationGroupFilter)

Filtrez les ensembles d'établissements de fiches d'établissement dynamiques.

DynamicBusinessProfileLocationGroupFilter

Représente un filtre sur les établissements d'un ensemble d'assets. Si vous fournissez plusieurs filtres, ils sont reliés par un opérateur AND.

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

string

Permet de filtrer les établissements de vos fiches par libellé. Seuls les établissements associés à l'un des libellés listés seront inclus dans l'ensemble d'assets. Les filtres par libellé sont reliés par un opérateur OU.

listingIdFilters[]

string (int64 format)

Permet de filtrer les établissements de vos fiches par ID de fiche.

businessNameFilter

object (BusinessProfileBusinessNameFilter)

Permet de filtrer les établissements de vos fiches par nom.

BusinessProfileBusinessNameFilter

Filtre par nom d'entreprise du groupe de 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 de filtres de chaîne de lieu possibles.

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

ChainLocationGroup

Représente des informations sur un groupe d'établissements dynamiques d'une chaîne. Ne s'applique que si le type de l'AssetSet de niveau de synchronisation est LOCATION_SYNC et que 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 à la ou aux chaînes spécifiées seront inclus dans l'ensemble d'assets.