REST Resource: accounts.locations

Ressource : Location

Un établissement. Consultez l'article du Centre d'aide pour obtenir une description détaillée de ces champs ou le point de terminaison de la catégorie pour obtenir la liste des catégories d'activité valides.

Représentation JSON 
{
  "name": string,
  "languageCode": string,
  "storeCode": string,
  "title": string,
  "phoneNumbers": {
    object (PhoneNumbers)
  },
  "categories": {
    object (Categories)
  },
  "storefrontAddress": {
    object (PostalAddress)
  },
  "websiteUri": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "metadata": {
    object (Metadata)
  },
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ],
  "serviceItems": [
    {
      object (ServiceItem)
    }
  ]
}
Champs
name

string

Identifiant Google de cet établissement, au format suivant: locations/{locationId}.
languageCode

string

Immuable. Langue du lieu. Défini lors de la création et non modifiable.
storeCode

string

Facultatif. Identifiant externe associé à cet établissement, qui doit être unique au sein d'un compte donné. Cela vous permet d'associer l'établissement à vos propres données.
title

string

Obligatoire. Le nom de l'établissement doit correspondre au nom réel de votre établissement, tel qu'il est connu des clients, tel qu'il figure sur votre devanture, votre site Web et vos documents. Toute information supplémentaire, le cas échéant, peut être incluse dans d'autres champs de la ressource (par exemple, Address ou Categories). N'ajoutez pas d'informations inutiles à votre nom (par exemple, préférez "Google" plutôt que "Google Inc. - Siège social de Mountain View"). N'ajoutez pas de slogan marketing, de codes de magasin, de caractères spéciaux, d'horaires d'ouverture, d'état de fermeture ou d'ouverture, de numéros de téléphone, d'URL de sites Web, d'informations sur les services ou produits, d'informations sur le lieu, l'adresse, l'itinéraire, ni sur l'endroit où se trouve l'établissement (par exemple, "Distributeur de billets Banque centrale à Biarritz).
phoneNumbers

object (PhoneNumbers)

Facultatif. Les différents numéros de téléphone que les clients peuvent utiliser pour contacter l'établissement.
categories

object (Categories)

Facultatif. Les différentes catégories décrivant l'établissement.
storefrontAddress

object (PostalAddress)

Facultatif. Adresse précise et exacte permettant de décrire votre établissement. Les boîtes postales ou boîtes aux lettres situées à des adresses distantes ne sont pas autorisées. Pour le moment, vous pouvez spécifier un maximum de cinq valeurs addressLines dans l'adresse. Ce champ ne doit être défini que pour les établissements qui ont une vitrine. Ce champ ne doit pas être défini pour des zones géographiques de type CUSTOMER_LOCATION_ONLY. Toutefois, s'il est défini, toute valeur fournie sera supprimée.
websiteUri

string

Facultatif. URL de cet établissement. Si possible, utilisez une URL qui représente l'établissement en question plutôt qu'un site Web/une URL générique qui représente tous les établissements ou la marque.
regularHours

object (BusinessHours)

Facultatif. Horaires d'ouverture de l'établissement
specialHours

object (SpecialHours)

Facultatif. Horaires d'ouverture exceptionnels de l'établissement. Cela inclut généralement les horaires de jours fériés et d'autres heures en dehors des heures d'ouverture habituelles. Ces horaires remplacent les horaires d'ouverture habituels. Ce champ ne peut pas être défini sans horaires normaux.
serviceArea

object (ServiceAreaBusiness)

Facultatif. Les établissements de services de proximité à domicile proposent leurs services à l'adresse du client. S'il s'agit d'un établissement de services de proximité à domicile, ce champ décrit la ou les zones desservies par l'établissement.
labels[]

string

Facultatif. Ensemble de chaînes au format libre pour vous permettre d'ajouter des tags à votre établissement. Ces libellés ne sont PAS visibles par l'utilisateur. vous seul pouvez les voir. Le nom doit comporter entre 1 et 255 caractères par étiquette.
adWordsLocationExtensions

object (AdWordsLocationExtensions)

Facultatif. Informations supplémentaires qui s'affichent dans AdWords.
latlng

object (LatLng)

Facultatif. Latitude et longitude fournies par l'utilisateur. Lors de la création d'un établissement, ce champ est ignoré si l'adresse fournie est correctement géocodée. Ce champ n'est affiché dans les demandes GET que si la valeur latlng fournie par l'utilisateur a été acceptée lors de la création ou si la valeur latlng a été modifiée via le site Web de la fiche d'établissement Google. Ce champ ne peut être mis à jour que par des clients approuvés.
openInfo

object (OpenInfo)

Facultatif. Indicateur indiquant si l'établissement est actuellement ouvert.
metadata

object (Metadata)

Uniquement en sortie. Autres informations non modifiables par l'utilisateur.
profile

object (Profile)

Facultatif. Décrivez votre entreprise avec vos propres mots, et partagez avec les utilisateurs l'histoire unique de votre entreprise et de vos offres.

Ce champ est obligatoire pour toutes les catégories, à l'exception des catégories d'hébergement (par exemple, les hôtels, les motels et les auberges).
relationshipData

object (RelationshipData)

Facultatif. Tous les établissements et la chaîne associés.
moreHours[]

object (MoreHours)

Facultatif. Des horaires supplémentaires pour les différents services d'un établissement ou des clients spécifiques.
serviceItems[]

object (ServiceItem)

Facultatif. Liste des services acceptés par les marchands. Il peut s'agir d'une coupe de cheveux, de l'installation d'un chauffe-eau, etc. Les articles d'entretien dupliqués sont automatiquement supprimés.

PhoneNumbers

Ensemble des numéros de téléphone de l'établissement. Lors des mises à jour, les deux champs doivent être définis. Les clients ne peuvent pas se contenter de mettre à jour le numéro de téléphone principal ou les numéros de téléphone supplémentaires à l'aide du masque de mise à jour. Le format de téléphone international est à privilégier (par exemple, "+1 415 555 0132"). Pour en savoir plus, consultez https://developers.google.com/style/phone-numbers#international-phone-numbers).

Représentation JSON 
{
  "primaryPhone": string,
  "additionalPhones": [
    string
  ]
}
Champs
primaryPhone

string

Obligatoire. Un numéro de téléphone permettant d'être directement mis en relation avec votre établissement Dans la mesure du possible, indiquez le numéro de téléphone local de votre établissement plutôt que celui d'un centre d'appels.
additionalPhones[]

string

Facultatif. Jusqu'à deux numéros de téléphone (mobile ou fixe, pas de fax) permettant de joindre votre établissement, en plus du numéro de téléphone principal

Catégories

Ensemble de catégories décrivant l'établissement. Lors des mises à jour, les deux champs doivent être définis. Les clients ne sont pas autorisés à mettre à jour individuellement les catégories principales ou supplémentaires à l'aide du masque de mise à jour.

Représentation JSON 
{
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ]
}
Champs
primaryCategory

object (Category)

Obligatoire. Catégorie qui décrit le mieux l'activité principale de l'établissement.
additionalCategories[]

object (Category)

Facultatif. Catégories supplémentaires permettant de décrire votre entreprise. Les catégories permettent à vos clients de trouver des résultats précis et spécifiques pour les services qui les intéressent. Pour que les informations sur votre établissement restent exactes et à jour, veillez à utiliser le moins de catégories possible pour décrire votre activité principale. Choisissez des catégories aussi spécifiques que possible, tout en veillant à ce qu'elles correspondent bien à votre activité principale.

Catégorie

Catégorie décrivant l'établissement (pas ses activités). Pour obtenir la liste des ID de catégorie valides et des mappages avec leurs noms lisibles, consultez categories.list.

Représentation JSON 
{
  "name": string,
  "displayName": string,
  "serviceTypes": [
    {
      object (ServiceType)
    }
  ],
  "moreHoursTypes": [
    {
      object (MoreHoursType)
    }
  ]
}
Champs
name

string

Obligatoire. Un identifiant stable (fourni par Google) pour cette catégorie. Cette valeur doit être spécifiée lorsque vous modifiez la catégorie (lors de la création ou de la mise à jour d'un établissement).
displayName

string

Uniquement en sortie. Nom lisible de la catégorie. Il est défini lors de la lecture de l'emplacement. Lorsque vous modifiez l'emplacement, category_id doit être défini.
serviceTypes[]

object (ServiceType)

Uniquement en sortie. Liste de tous les types de services disponibles pour cette catégorie d'activité.
moreHoursTypes[]

object (MoreHoursType)

Uniquement en sortie. Autres types d'horaires disponibles pour cette catégorie d'activité.

ServiceType

Message décrivant un type de service proposé par l'établissement.

Représentation JSON 
{
  "serviceTypeId": string,
  "displayName": string
}
Champs
serviceTypeId

string

Uniquement en sortie. ID stable (fourni par Google) pour ce type de service.
displayName

string

Uniquement en sortie. Nom lisible à afficher pour le type de service.

MoreHoursType

Autres types d'horaires qu'un établissement peut proposer, en plus de ses horaires habituels.

Représentation JSON 
{
  "hoursTypeId": string,
  "displayName": string,
  "localizedDisplayName": string
}
Champs
hoursTypeId

string

Uniquement en sortie. Identifiant stable fourni par Google pour ce type d'horaires.
displayName

string

Uniquement en sortie. Nom lisible à afficher en anglais pour le type d'horaires.
localizedDisplayName

string

Uniquement en sortie. Nom à afficher, localisé et intelligible, pour le type d'horaires.

PostalAddress

Représente une adresse postale, telles que des adresses de livraison ou de paiement. Les services postaux peuvent effectuer une livraison à cette adresse, boîte postale ou autre. Ce champ n'a pas vocation à modéliser des emplacements géographiques (routes, villes ou montagnes).

Généralement, une adresse est créée via une saisie utilisateur ou lors de l'importation de données existantes, en fonction du type de processus.

Conseils pour la saisie ou la modification d'adresse : utilisez un widget d'adresse compatible avec l'internationalisation, tel que https://github.com/google/libaddressinput. Les utilisateurs ne doivent pas voir d'éléments d'interface utilisateur permettant de saisir ou de modifier des champs en dehors des pays où ce champ est utilisé.

Pour en savoir plus sur l'utilisation de ce schéma, consultez la page https://support.google.com/business/answer/6397478.

Représentation JSON 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Champs
revision

integer

Révision du schéma de PostalAddress. Il doit être défini sur 0, à savoir la dernière révision.

Toutes les nouvelles révisions doivent être rétrocompatibles avec les anciennes révisions.
regionCode

string

Obligatoire. Code pays/région CLDR de l'adresse. Il n'est jamais déduit, et il revient à l'utilisateur de s'assurer que la valeur est correcte. Pour en savoir plus, consultez les pages https://cldr.unicode.org/ et https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Exemple : "CH" pour la Suisse.
languageCode

string

Facultatif. Code de langue BCP-47 du contenu de cette adresse (s'il est connu). Il s'agit souvent de la langue d'UI du formulaire de saisie. Sinon, il doit correspondre à l'une des langues utilisées dans le pays/la région mentionnés dans l'adresse ou leurs équivalents translittérés. Ce champ peut modifier la mise en forme dans certains pays, mais cela ne risque pas de nuire à l'exactitude des données et n'affectera jamais aucune validation ni aucune opération ne concernant pas la mise en forme.

Si cette valeur est inconnue, vous devez l'omettre (plutôt que de spécifier une valeur par défaut éventuellement incorrecte).

Exemples : "zh-Hant", "ja", "ja-Latn" et "en".
postalCode

string

Facultatif. Code postal de l'adresse. Tous les pays n'utilisent pas ou n'exigent pas de codes postaux, mais lorsqu'ils s'en servent, ils peuvent déclencher une validation supplémentaire avec d'autres parties de l'adresse (par exemple, validation par État/code postal aux États-Unis).
sortingCode

string

Facultatif. Code de tri supplémentaire, spécifique à chaque pays. La plupart des régions ne s'en servent pas. Lorsqu'il est utilisé, sa valeur comprend une chaîne de type CEDEX, éventuellement suivie d'un numéro (par exemple CEDEX 7), ou tout simplement un nombre représentant un "code de secteur" (Jamaïque), un "indicateur de zone de livraison" (Malawi) ou un "indicateur postal" (Côte d'Ivoire, par exemple).
administrativeArea

string

Facultatif. Plus haute subdivision administrative utilisée pour les adresses postales d'un pays ou d'une région. Par exemple, il peut s'agir d'un État, d'une province, d'un oblast ou d'une préfecture. Plus précisément, pour l'Espagne, il s'agit de la province et non de la communauté autonome (par exemple, "Barcelone" et non "Catalogne"). De nombreux pays n'utilisent pas de région administrative dans leurs adresses postales. Par exemple, ce champ doit rester vide en Suisse.
locality

string

Facultatif. Fait généralement référence à la ville de l'adresse. Exemples : une "city" aux États-Unis, une "comune" en Italie, une "post town" au Royaume-Uni. Dans les régions du monde où les localités ne sont pas bien définies ou ne s'intègrent pas bien dans cette structure, laissez le champ de localité vide et utilisez addressLines.
sublocality

string

Facultatif. Sous-localité de l'adresse. Il peut s'agir, par exemple, de quartiers, d'arrondissements ou de districts.
addressLines[]

string

Lignes d'adresse non structurées décrivant les niveaux inférieurs d'une adresse.

Étant donné que les valeurs dans "addressLines" ne contiennent pas d'informations de type et peuvent parfois comprendre plusieurs valeurs dans un seul champ (par exemple, "Austin, TX"), il est important que l'ordre des lignes soit bien clair. L'ordre des lignes d'adresse doit correspondre à l'ordre suivi sur les enveloppes pour le pays/la région de l'adresse. Dans les pays où cet ordre peut varier (par exemple, au Japon), "address_language" est utilisé pour le rendre explicite (par exemple, "ja" pour un ordre décroissant et "ja-Latn" ou "en" pour un ordre croissant). De cette façon, la ligne la plus spécifique d'une adresse peut être sélectionnée en fonction de la langue.

La représentation structurelle minimale autorisée d'une adresse consiste en un code "regionCode" avec toutes les informations restantes placées dans les lignes "adresseLines". Il serait possible de mettre en forme une telle adresse de manière très approximative sans géocodage, mais aucun raisonnement sémantique ne pourrait être réalisé quant à l'un des composants d'adresse avant qu'il n'ait été au moins partiellement résolu.

La création d'une adresse contenant uniquement un code "regionCode" et des lignes "addressLines" suivi d'un géocodage est la méthode recommandée pour gérer les adresses complètement déstructurées (plutôt que de deviner quelles parties de l'adresse sont des localités ou des régions administratives).
recipients[]

string

Facultatif. Destinataire. Ce champ peut, dans certaines circonstances, contenir des informations multilignes. Par exemple, il peut comporter la ligne "chez".
organization

string

Facultatif. Nom de l'entreprise.

BusinessHours

Représente les périodes d'ouverture de l'établissement. Contient une collection d'instances [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod].

Représentation JSON 
{
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
Champs
periods[]

object (TimePeriod)

Obligatoire. Ensemble des horaires d'ouverture de cet établissement. Chaque période correspond à un intervalle d'heures pendant lequel l'établissement est ouvert pendant la semaine.

TimePeriod

Représente la période d'ouverture de l'établissement, à partir du jour et de l'heure d'ouverture spécifiés, jusqu'au jour et à l'heure de fermeture spécifiés. L'heure de fermeture doit être postérieure à l'heure d'ouverture (par exemple, plus tard le même jour ou un jour suivant).

Représentation JSON 
{
  "openDay": enum (DayOfWeek),
  "openTime": {
    object (TimeOfDay)
  },
  "closeDay": enum (DayOfWeek),
  "closeTime": {
    object (TimeOfDay)
  }
}
Champs
openDay

enum (DayOfWeek)

Obligatoire. Indique le day of the week à partir duquel cette période commence.
openTime

object (TimeOfDay)

Obligatoire. Les valeurs valides sont comprises entre 00:00 et 24:00, où 24:00 correspond à minuit à la fin du champ de jour spécifié.
closeDay

enum (DayOfWeek)

Obligatoire. Indique le day of the week auquel se termine cette période.
closeTime

object (TimeOfDay)

Obligatoire. Les valeurs valides sont comprises entre 00:00 et 24:00, où 24:00 correspond à minuit à la fin du champ de jour spécifié.

DayOfWeek

Représente un jour de la semaine.

Enums
DAY_OF_WEEK_UNSPECIFIED Le jour de la semaine n'est pas spécifié.
MONDAY Lundi
TUESDAY Mardi
WEDNESDAY Mercredi
THURSDAY Jeudi
FRIDAY Vendredi
SATURDAY Samedi
SUNDAY Dimanche

TimeOfDay

Représente une heure de la journée. La date et le fuseau horaire sont spécifiés ailleurs, ou ne sont pas significatifs. Une API peut choisir d'autoriser des secondes intercalaires. Les types associés sont google.type.Date et google.protobuf.Timestamp.

Représentation JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Champs
hours

integer

Heure de la journée au format 24 heures. Elle doit être comprise entre 0 à 23. Une API peut choisir d'autoriser la valeur "24:00:00" pour des cas tels que l'heure de fermeture des bureaux.
minutes

integer

Minutes de l'heure de la journée. Elles doivent être comprises entre 0 à 59.
seconds

integer

Secondes de l'heure de la journée. Elles doivent normalement être comprises entre 0 et 59. Une API peut autoriser la valeur 60 si elle autorise les secondes intercalaires.
nanos

integer

Fractions de secondes en nanosecondes. La valeur doit être comprise entre 0 et 999 999 999.

SpecialHours

Représente un ensemble de périodes au cours desquelles les horaires d'ouverture d'un établissement diffèrent des horaires d'ouverture habituels.

Représentation JSON 
{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}
Champs
specialHourPeriods[]

object (SpecialHourPeriod)

Obligatoire. Liste des exceptions aux horaires d'ouverture habituels de l'établissement.

SpecialHourPeriod

Représente une période unique au cours de laquelle les horaires d'ouverture d'un établissement diffèrent des horaires d'ouverture habituels. Une période d'horaires d'ouverture exceptionnels doit représenter une plage de moins de 24 heures. Les openTime et startDate doivent être antérieures aux closeTime et endDate. Les closeTime et endDate peuvent s'étendre jusqu'à 23h59 le lendemain de la startDate spécifiée. Par exemple, les entrées suivantes sont valides:

startDate=2015-11-23, openTime=08:00, closeTime=18:00
startDate=2015-11-23, endDate=2015-11-23, openTime=08:00,
closeTime=18:00 startDate=2015-11-23, endDate=2015-11-24,
openTime=13:00, closeTime=11:59

Les entrées suivantes ne sont pas valides:

startDate=2015-11-23, openTime=13:00, closeTime=11:59
startDate=2015-11-23, endDate=2015-11-24, openTime=13:00,
closeTime=12:00 startDate=2015-11-23, endDate=2015-11-25,
openTime=08:00, closeTime=18:00
Représentation JSON 
{
  "startDate": {
    object (Date)
  },
  "openTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "closeTime": {
    object (TimeOfDay)
  },
  "closed": boolean
}
Champs
startDate

object (Date)

Obligatoire. Date du calendrier à laquelle commence cette période d'horaires d'ouverture exceptionnels.
openTime

object (TimeOfDay)

Facultatif. Les valeurs valides sont comprises entre 00:00 et 24:00, où 24:00 correspond à minuit à la fin du champ de jour spécifié. Doit être spécifié si closed est défini sur "false".
endDate

object (Date)

Facultatif. Date de fin de cette période d'horaires d'ouverture exceptionnels. Si le champ endDate n'est pas défini, la date spécifiée dans startDate est utilisée par défaut. S'il est défini, ce champ doit être égal ou inférieur à 1 jour après startDate.
closeTime

object (TimeOfDay)

Facultatif. Les valeurs valides sont comprises entre 00:00 et 24:00, où 24:00 correspond à minuit à la fin du champ de jour spécifié. Doit être spécifié si closed est défini sur "false".
closed

boolean

Facultatif. Si la valeur est "true", endDate, openTime et closeTime sont ignorés, et la date spécifiée dans startDate est traitée comme l'établissement fermé toute la journée.

Date

Représente une date du calendrier entière ou partielle, par exemple un anniversaire. L'heure de la journée et le fuseau horaire sont spécifiés ailleurs, ou ne sont pas significatifs. La date est donnée selon le calendrier grégorien. Il peut s'agir de l'un des éléments suivants:

  • Une date complète, avec des valeurs non nulles pour l'année, le mois et le jour.
  • Un mois et un jour, avec une année nulle (par exemple, un anniversaire).
  • une année seule, avec un mois et un jour zéro.
  • Une année et un mois, avec un jour zéro (par exemple, la date d'expiration d'une carte de crédit).

Types associés:

Représentation JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Champs
year

integer

Année de la date. Doit être comprise entre 1 et 9999, ou 0 pour indiquer une date sans année.
month

integer

Mois de l'année. La valeur doit être comprise entre 1 et 12, ou égale à 0 pour spécifier une année sans mois ni jour.
day

integer

Jour du mois. Doit être compris entre 1 et 31, et valide pour l'année et le mois, ou 0 pour indiquer une année seule, ou une année et un mois où le jour n'est pas significatif.

ServiceAreaBusiness

Les établissements de services de proximité à domicile proposent leurs services à l'adresse du client (par exemple, un serrurier ou un plombier).

Représentation JSON 
{
  "businessType": enum (BusinessType),
  "places": {
    object (Places)
  },
  "regionCode": string
}
Champs
businessType

enum (BusinessType)

Obligatoire. Indique le [type] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] de l'établissement de services de proximité à domicile.
places

object (Places)

Zone desservie par cet établissement, définie via un ensemble d'adresses.
regionCode

string

Immuable. Code CLDR du pays ou de la région où est située cette zone desservie. Pour en savoir plus, consultez les pages http://cldr.unicode.org/ et http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Exemple : "CH" pour la Suisse.

Ce champ est obligatoire pour les établissements de CUSTOMER_LOCATION_ONLY et est ignoré dans les autres cas.

La région spécifiée ici peut être différente des régions correspondant aux zones desservies par cet établissement (par exemple, les établissements de services de proximité à domicile qui fournissent des services dans des régions autres que celle dans laquelle ils sont basés).

Si cet établissement doit être validé après sa création, l'adresse fournie pour la validation doit être située dans cette région, et le propriétaire de l'établissement ou son représentant autorisé doit être en mesure de recevoir du courrier postal à l'adresse de validation fournie.

BusinessType

Indique si cet établissement propose uniquement des services sur place au domicile du client (par exemple, une dépanneuse) ou à la fois à une adresse et sur place (par exemple, une pizzeria dotée d'un espace repas, qui livre aussi à ses clients).

Enums
BUSINESS_TYPE_UNSPECIFIED Uniquement en sortie. Non spécifié.
CUSTOMER_LOCATION_ONLY Offre un service uniquement aux alentours (pas à l'adresse de l'établissement). Si un établissement passe de CUSTOMER_AND_BUSINESS_LOCATION à CUSTOMER_LOCATION_ONLY, la mise à jour de l'établissement doit inclure le masque de champ storefrontAddress et laisser le champ vide.
CUSTOMER_AND_BUSINESS_LOCATION Propose un service à l'adresse de l'établissement et aux alentours.

Places

Définit l'union de zones représentées par un ensemble de lieux.

Représentation JSON 
{
  "placeInfos": [
    {
      object (PlaceInfo)
    }
  ]
}
Champs
placeInfos[]

object (PlaceInfo)

Zones représentées par des ID de lieu. 20 emplacements maximum.

PlaceInfo

Définit une zone représentée par un ID de lieu.

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

string

Obligatoire. Nom localisé du lieu. Par exemple, Scottsdale, AZ.
placeId

string

Obligatoire. Identifiant du lieu. Doit correspondre à une région. (https://developers.google.com/places/web-service/supported_types#table3)

AdWordsLocationExtensions

Informations supplémentaires qui s'affichent dans AdWords.

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

string

Obligatoire. Numéro de téléphone secondaire à afficher dans les extensions de lieu AdWords au lieu du numéro de téléphone principal de l'établissement.

LatLng

Objet représentant une paire latitude/longitude. Elle est exprimée par une paire de doubles représentant les degrés de latitude et de longitude. Sauf indication contraire, cet objet doit être conforme à la norme WGS84. Les valeurs doivent se situer dans les limites normalisées.

Représentation JSON 
{
  "latitude": number,
  "longitude": number
}
Champs
latitude

number

Latitude en degrés. Elle doit être comprise dans la plage [-90.0, +90.0].
longitude

number

Longitude en degrés. Elle doit être comprise dans la plage [-180.0, +180.0].

OpenInfo

Informations sur l'état d'ouverture de l'établissement.

Représentation JSON 
{
  "status": enum (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}
Champs
status

enum (OpenForBusiness)

Obligatoire. Indique si l'établissement est actuellement ouvert ou non. Tous les établissements sont ouverts par défaut, sauf s'ils sont modifiés comme étant fermés.
canReopen

boolean

Uniquement en sortie. Indique si l'établissement peut être rouvert.
openingDate

object (Date)

Facultatif. Date de la première ouverture de l'établissement. Si le jour exact n'est pas connu, seuls le mois et l'année peuvent être indiqués. La date doit être antérieure à la date du jour ou ne pas être postérieure à plus d'un an.

OpenForBusiness

Indique l'état d'un établissement.

Enums
OPEN_FOR_BUSINESS_UNSPECIFIED Non spécifié.
OPEN Indique que l'établissement est ouvert.
CLOSED_PERMANENTLY indique que l'établissement a été définitivement fermé.
CLOSED_TEMPORARILY indique que l'établissement a été temporairement fermé.

Métadonnées

Autres informations sur l'établissement non modifiables par l'utilisateur.

Représentation JSON 
{
  "hasGoogleUpdated": boolean,
  "hasPendingEdits": boolean,
  "canDelete": boolean,
  "canOperateLocalPost": boolean,
  "canModifyServiceList": boolean,
  "canHaveFoodMenus": boolean,
  "canOperateHealthData": boolean,
  "canOperateLodgingData": boolean,
  "placeId": string,
  "duplicateLocation": string,
  "mapsUri": string,
  "newReviewUri": string,
  "canHaveBusinessCalls": boolean,
  "hasVoiceOfMerchant": boolean
}
Champs
hasGoogleUpdated

boolean

Uniquement en sortie. Indique si l'ID de lieu associé à cet établissement comporte des mises à jour qui doivent être mises à jour ou refusées par le client. Si cette valeur booléenne est définie, vous devez appeler la méthode getGoogleUpdated pour rechercher les informations à vérifier.
hasPendingEdits

boolean

Uniquement en sortie. Indique si l'une des propriétés de cet établissement est en attente de modification.
canDelete

boolean

Uniquement en sortie. Indique si l'établissement peut être supprimé à l'aide de l'API.
canOperateLocalPost

boolean

Uniquement en sortie. Indique si la fiche peut gérer les posts locaux.
canModifyServiceList

boolean

Uniquement en sortie. Indique si la fiche peut modifier la liste de services.
canHaveFoodMenus

boolean

Uniquement en sortie. Indique si la fiche peut bénéficier d'un menu.
canOperateHealthData

boolean

Uniquement en sortie. Indique si l'établissement peut exploiter les données de santé.
canOperateLodgingData

boolean

Uniquement en sortie. Indique si l'établissement peut exploiter les données sur l'hébergement.
placeId

string

Uniquement en sortie. Si ce lieu apparaît sur Google Maps, l'ID du lieu est inséré dans ce champ. Cet ID peut être utilisé dans diverses API Places.

Ce champ peut être défini lors des appels Create, mais pas Update.
duplicateLocation

string

Uniquement en sortie. Ressource d'établissement dupliquée par cet établissement.
mapsUri

string

Uniquement en sortie. Lien vers l'établissement sur Maps.
newReviewUri

string

Uniquement en sortie. Lien vers la page de la recherche Google sur laquelle les clients peuvent laisser un avis sur l'établissement.
canHaveBusinessCalls

boolean

Uniquement en sortie. Indique si la fiche peut recevoir des appels professionnels.
hasVoiceOfMerchant

boolean

Uniquement en sortie. Indique si la fiche contient la voix du marchand. Si la valeur booléenne est "false", vous devez appeler l'API locations.getVoiceOfMerchantState pour savoir pourquoi ils ne disposent pas de Voice of Merchant.

Profil

Toutes les informations concernant le profil de l'établissement.

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

string

Obligatoire. Description du lieu de votre propre voix, non modifiable par les autres utilisateurs.

RelationshipData

Informations sur tous les emplacements parents et enfants associés à celui-ci.

Représentation JSON 
{
  "parentLocation": {
    object (RelevantLocation)
  },
  "childrenLocations": [
    {
      object (RelevantLocation)
    }
  ],
  "parentChain": string
}
Champs
parentLocation

object (RelevantLocation)

Emplacement parent avec lequel cet établissement est en relation.
childrenLocations[]

object (RelevantLocation)

Liste des emplacements enfants avec lesquels cet établissement est en relation.
parentChain

string

Nom de ressource de la chaîne à laquelle appartient l'établissement. [Comment trouver l'ID de chaîne] [Locations.SearchChains]

RelevantLocation

Informations sur un autre établissement associé à l'établissement actuel. La relation peut être n'importe quelle relation entre DEPARTMENT_OF ou INDEPENDENT_ESTABLISHMENT_OF, et l'emplacement spécifié ici peut se trouver de chaque côté (parent/enfant) du lieu.

Représentation JSON 
{
  "placeId": string,
  "relationType": enum (RelationType)
}
Champs
placeId

string

Obligatoire. Spécifiez l'emplacement situé de l'autre côté de la relation par son identifiant de lieu.
relationType

enum (RelationType)

Obligatoire. Type de la relation.

RelationType

Relations entre les types à spécifier.

Enums
RELATION_TYPE_UNSPECIFIED Type non spécifié
DEPARTMENT_OF Il s'agit d'une relation entre deux établissements qui partagent une même zone physique et qui sont associés à la même marque/la même direction/entreprise, mais qui présentent des attributs clés différents (horaires d'ouverture ou numéros de téléphone, par exemple). Par exemple, Pharmacie des Corais est un rayon du groupe Auchan.
INDEPENDENT_ESTABLISHMENT_IN Il s'agit des cas où deux établissements sont situés au même endroit, mais dans des entreprises différentes (par exemple, Starbucks dans une Safeway, magasins dans un centre commercial).

MoreHours

Périodes d'ouverture pour certains types d'entreprises.

Représentation JSON 
{
  "hoursTypeId": string,
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
Champs
hoursTypeId

string

Obligatoire. Type d'horaires. Les clients doivent appeler {#link businessCategories:BatchGet} pour obtenir les types d'horaires d'ouverture acceptés pour les catégories de leurs établissements.
periods[]

object (TimePeriod)

Obligatoire. Ensemble des horaires d'ouverture de cet établissement. Chaque période correspond à un intervalle d'heures pendant lequel l'établissement est ouvert pendant la semaine.

ServiceItem

Message décrivant un seul élément de service. Il permet de décrire le type de service fourni par le marchand. Par exemple, coiffure peut être un service.

Représentation JSON 
{
  "price": {
    object (Money)
  },

  // Union field service_item_info can be only one of the following:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of list of possible types for union field service_item_info.
}
Champs
price

object (Money)

Facultatif. Représente le prix monétaire de l'élément de service. Nous vous recommandons de définir "currencyCode" et les unités lorsque vous incluez un prix. Il sera traité comme un prix fixe pour l'article du service.
Champ d'union service_item_info. L'un des champs suivants doit toujours être défini. service_item_info ne peut être qu'un des éléments suivants :
structuredServiceItem

object (StructuredServiceItem)

Facultatif. La casse de ce champ sera définie pour les données de services structurées.
freeFormServiceItem

object (FreeFormServiceItem)

Facultatif. Ce champ sera défini pour les données de services de format libre.

StructuredServiceItem

Représente un service structuré proposé par le marchand. Par exemple: installation de toilettes.

Représentation JSON 
{
  "serviceTypeId": string,
  "description": string
}
Champs
serviceTypeId

string

Obligatoire. Le champ serviceTypeId est un identifiant unique fourni par Google, qui se trouve dans ServiceType. Ces informations sont fournies par le service RPC categories.batchGet.
description

string

Facultatif. Description de l'élément de service structuré. Le nombre maximal de caractères est de 300.

FreeFormServiceItem

Représente un service de format libre proposé par le marchand. Il s'agit de services qui ne sont pas exposés dans les données de notre service de structure. Le marchand saisit manuellement le nom de ces services via une surface geomerchant.

Représentation JSON 
{
  "category": string,
  "label": {
    object (Label)
  }
}
Champs
category

string

Obligatoire. Ce champ représente le nom de la catégorie (identifiant stable de la catégorie). category et serviceTypeId doivent correspondre aux combinaisons possibles fournies dans le message Category.
label

object (Label)

Obligatoire. Libellés de l'élément avec marquage de la langue. Nous recommandons de ne pas dépasser 140 caractères pour les noms d'éléments et 250 caractères pour les descriptions. Ce champ ne doit être défini que si l'entrée est un élément de service personnalisé. Les types de services standardisés doivent être mis à jour via serviceTypeId.

Libellé

Libellé à utiliser pour afficher la liste de prix, la section ou l'article.

Représentation JSON 
{
  "displayName": string,
  "description": string,
  "languageCode": string
}
Champs
displayName

string

Obligatoire. Nom à afficher de la liste de prix, de la section ou de l'article.
description

string

Facultatif. Description de la liste de prix, de la section ou de l'article.
languageCode

string

Facultatif. Code de langue BCP-47 auquel ces chaînes s'appliquent. Vous ne pouvez définir qu'un seul ensemble de libellés par langue.

Valeur monétaire

Représente un montant associé à un type de devise.

Représentation JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Champs
currencyCode

string

Code de devise à trois lettres défini dans la norme ISO 4217.
units

string (int64 format)

Unités entières du montant. Par exemple, si currencyCode correspond à "USD", une unité correspond à un dollar américain.
nanos

integer

Nombre de nano-unités (10^-9) du montant. La valeur doit être comprise entre -999 999 999 et +999 999 999 inclus. Si units est positif, nanos doit être positif ou nul. Si units est égal à zéro, nanos peut être positif, nul ou négatif. Si units est négatif, nanos doit être négatif ou nul. Par exemple, -1,75 $ est représenté par units=-1 et nanos=-750 000 000.

Méthodes

create

 Crée un établissement qui appartiendra à l'utilisateur connecté.

list

 Répertorie les établissements pour le compte spécifié.