- Ressource: Location
- Représentation JSON
- PhoneNumbers
- Catégories
- Catégorie
- ServiceType
- MoreHoursType
- PostalAddress
- BusinessHours
- TimePeriod
- DayOfWeek
- TimeOfDay
- SpecialHours
- SpecialHourPeriod
- Date
- ServiceAreaBusiness
- BusinessType
- Places
- PlaceInfo
- AdWordsLocationExtensions
- LatLng
- OpenInfo
- OpenForBusiness
- Métadonnées
- Profil
- RelationshipData
- RelevantLocation
- RelationType
- MoreHours
- ServiceItem
- StructuredServiceItem
- FreeFormServiceItem
- Libellé
- Valeur monétaire
- Méthodes
Ressource : Location
Un emplacement. 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 ( |
Champs | |
---|---|
name |
Identifiant Google de cet établissement, au format suivant: |
languageCode |
Immuable. Langue de l'établissement. Défini lors de la création et non modifiable. |
storeCode |
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 dossiers. |
title |
Obligatoire. Le nom de l'établissement doit correspondre au nom réel de votre établissement, tel qu'il est connu des clients et tel qu'il est indiqué sur votre vitrine, votre site Web et vos documents. Vous pouvez inclure d'autres informations, le cas échéant, dans d'autres champs de la ressource (par exemple, |
phoneNumbers |
Facultatif. Les différents numéros de téléphone que les clients peuvent utiliser pour contacter l'établissement |
categories |
Facultatif. Les différentes catégories qui décrivent l'établissement. |
storefrontAddress |
Facultatif. L'adresse exacte et précise de 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 |
websiteUri |
Facultatif. URL de cet établissement. Si possible, utilisez une URL qui représente l'établissement individuel plutôt qu'un site Web ou une URL générique qui représentent tous les établissements ou la marque. |
regularHours |
Facultatif. Horaires d'ouverture de l'établissement. |
specialHours |
Facultatif. Horaires d'ouverture exceptionnels de l'établissement. Il s'agit généralement des horaires de jours fériés et d'autres horaires en dehors des horaires d'ouverture habituels. Ces horaires prévalent sur les horaires d'ouverture habituels. Ce champ ne peut pas être défini sans horaires standards. |
serviceArea |
Facultatif. Les entreprises 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 les zones desservies par l'établissement. |
labels[] |
Facultatif. Ensemble de chaînes au format libre pour vous permettre d'ajouter des tags à votre établissement. Ces libellés ne sont PAS destinés aux utilisateurs ; vous seul pouvez les voir. Doit comporter entre 1 et 255 caractères par étiquette. |
adWordsLocationExtensions |
Facultatif. Informations supplémentaires qui s'affichent dans AdWords. |
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 renvoyé dans les demandes d'obtention que si la valeur |
openInfo |
Facultatif. Indicateur signalant si l'établissement est actuellement ouvert |
metadata |
Uniquement en sortie. Autres informations non modifiables par l'utilisateur. |
profile |
Facultatif. Décrit votre entreprise dans vos propres mots, et partage avec les utilisateurs l'histoire unique de votre entreprise et des produits ou services que vous proposez. Ce champ est obligatoire pour toutes les catégories à l'exception des catégories d'hébergement (par exemple, les hôtels, les motels, les auberges). |
relationshipData |
Facultatif. Tous les établissements et la chaîne associés à celui-ci. |
moreHours[] |
Facultatif. Horaires supplémentaires pour les différents services d'une entreprise ou des clients spécifiques. |
serviceItems[] |
Facultatif. Liste des services acceptés par les marchands. Il peut s'agir d'un coiffeur, d'une installation de chauffe-eau, etc. Les articles en double sont automatiquement supprimés. |
PhoneNumbers
Ensemble de 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 mettre à jour uniquement les numéros de téléphone principal ou supplémentaire à l'aide du masque de mise à jour. Le format de téléphone international est privilégié, 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 |
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[] |
Facultatif. Vous pouvez indiquer jusqu'à deux numéros de téléphone (mobile ou fixe, mais pas de fax) permettant de joindre votre établissement, en plus du numéro de téléphone principal. |
Categories
Ensemble de catégories qui décrit l'établissement. Lors des mises à jour, les deux champs doivent être définis. Il est interdit aux clients de mettre à jour individuellement les catégories principales ou supplémentaires à l'aide du masque de mise à jour.
Représentation JSON |
---|
{ "primaryCategory": { object ( |
Champs | |
---|---|
primaryCategory |
Obligatoire. Catégorie qui décrit le mieux l'activité principale de l'établissement. |
additionalCategories[] |
Facultatif. Catégories supplémentaires permettant de décrire votre établissement. Les catégories aident vos clients à 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, mais représentatives de votre activité principale. |
Catégorie
Catégorie décrivant l'établissement (et non ses activités). Pour obtenir la liste des ID de catégorie valides et les mappages avec leurs noms lisibles, consultez categories.list
.
Représentation JSON |
---|
{ "name": string, "displayName": string, "serviceTypes": [ { object ( |
Champs | |
---|---|
name |
Obligatoire. Un identifiant (fourni par Google) stable pour cette catégorie. Vous devez spécifier la valeur lorsque vous modifiez la catégorie (lors de la création ou de la mise à jour d'un établissement). |
displayName |
Uniquement en sortie. Nom de la catégorie dans un format lisible. Ce paramètre est défini lors de la lecture de l'emplacement. Lorsque vous modifiez l'emplacement, |
serviceTypes[] |
Uniquement en sortie. Liste de tous les types de services disponibles pour cette catégorie d'activité. |
moreHoursTypes[] |
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 |
Uniquement en sortie. ID stable (fourni par Google) pour ce type de service. |
displayName |
Uniquement en sortie. Nom lisible à afficher pour le type de service. |
MoreHoursType
Types d'horaires supplémentaires qu'un établissement peut proposer, en plus de ses horaires habituels.
Représentation JSON |
---|
{ "hoursTypeId": string, "displayName": string, "localizedDisplayName": string } |
Champs | |
---|---|
hoursTypeId |
Uniquement en sortie. ID stable fourni par Google pour ce type d'horaires. |
displayName |
Uniquement en sortie. Nom à afficher en anglais lisible par l'humain pour le type d'horaires. |
localizedDisplayName |
Uniquement en sortie. Nom à afficher localisé lisible 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 / modification d'adresses : utilisez un widget d'adresse prêt pour l'internationalisation, tel que https://github.com/google/libaddressinput. Les utilisateurs ne doivent pas voir les é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 |
Révision du schéma de Toutes les nouvelles révisions doivent être rétrocompatibles avec les anciennes révisions. |
regionCode |
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 |
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 |
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 |
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 |
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 |
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 |
Facultatif. Sous-localité de l'adresse. Il peut s'agir, par exemple, de quartiers, d'arrondissements ou de districts. |
addressLines[] |
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[] |
Facultatif. Destinataire. Ce champ peut, dans certaines circonstances, contenir des informations multilignes. Par exemple, il peut comporter la ligne "chez". |
organization |
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 ( |
Champs | |
---|---|
periods[] |
Obligatoire. Ensemble des heures d'ouverture de l'établissement. Chaque période correspond à une plage d'heures d'ouverture de l'établissement pendant la semaine. |
TimePeriod
Représente la période d'ouverture de l'établissement, à partir du jour ou de l'heure d'ouverture spécifiés et jusqu'au jour et à l'heure de fermeture spécifiés. L'heure de fermeture doit être postérieure à l'heure d'ouverture (plus tard dans la journée ou un jour suivant, par exemple).
Représentation JSON |
---|
{ "openDay": enum ( |
Champs | |
---|---|
openDay |
Obligatoire. Indique le |
openTime |
Obligatoire. Les valeurs valides vont de 00:00 à 24:00, où 24:00 correspond à minuit à la fin du champ de jour spécifié. |
closeDay |
Obligatoire. Indique le |
closeTime |
Obligatoire. Les valeurs valides vont de 00:00 à 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 |
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 |
Minutes de l'heure de la journée. Elles doivent être comprises entre 0 à 59. |
seconds |
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 |
Fractions de secondes en nanosecondes. La valeur doit être comprise entre 0 et 999 999 999. |
SpecialHours
Représente un ensemble de périodes pendant lesquelles les horaires d'ouverture d'un établissement diffèrent des horaires habituels.
Représentation JSON |
---|
{
"specialHourPeriods": [
{
object ( |
Champs | |
---|---|
specialHourPeriods[] |
Obligatoire. Liste des exceptions aux horaires d'ouverture habituels de l'établissement. |
SpecialHourPeriod
Représente une période unique pendant laquelle les horaires d'ouverture d'un établissement diffèrent des horaires 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 ( |
Champs | |
---|---|
startDate |
Obligatoire. Date de début de cette période d'horaires d'ouverture exceptionnels. |
openTime |
Facultatif. Les valeurs valides vont de 00:00 à 24:00, où 24:00 correspond à minuit à la fin du champ de jour spécifié. Doit être spécifié si |
endDate |
Facultatif. Date de fin de cette période d'horaires d'ouverture exceptionnels. Si le champ |
closeTime |
Facultatif. Les valeurs valides vont de 00:00 à 24:00, où 24:00 correspond à minuit à la fin du champ de jour spécifié. Doit être spécifié si |
closed |
Facultatif. Si la valeur est "true", |
Date
Représente une date calendaire complète 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 relative au calendrier grégorien. Il peut s'agir de l'un des éléments suivants:
- Date complète, avec des valeurs d'année, de mois et de jour non nulles.
- Jour et mois, avec une année nulle (un anniversaire, par exemple).
- Une année seule, avec un mois et un jour zéro.
- Année et mois, avec un jour zéro (par exemple, la date d'expiration d'une carte de crédit).
Types associés:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
Représentation JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
Champs | |
---|---|
year |
Année de la date. La valeur doit être comprise entre 1 et 9999, ou égale à 0 pour indiquer une date sans année. |
month |
Mois de l'année. La valeur doit être comprise entre 1 et 12, ou 0 pour indiquer une année sans mois ni jour. |
day |
Jour du mois. Doit être compris entre 1 et 31, et valide pour l'année et le mois, ou la valeur 0 pour indiquer une année seule, ou une année et un mois où le jour n'est pas significatif. |
ServiceAreaBusiness
Les entreprises de services de proximité à domicile proposent leurs services à l'adresse du client (par exemple, serrurier ou plombier).
Représentation JSON |
---|
{ "businessType": enum ( |
Champs | |
---|---|
businessType |
Obligatoire. Indique le [type] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] de l'établissement de services de proximité à domicile. |
places |
Zone desservie par cet établissement, définie via un ensemble de lieux. |
regionCode |
Immuable. Code CLDR du pays ou de la région où est situé cet établissement de services de proximité à domicile. 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 type CUSTOMER_LOCATION_ONLY. Il est ignoré dans les autres cas. La région spécifiée ici peut être différente des régions des zones desservies par cet établissement. Il peut s'agir, par exemple, d'établissements de services de proximité à domicile qui proposent 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 pouvoir recevoir du courrier postal à l'adresse de validation fournie. |
BusinessType
Indique si cet établissement ne propose des services sur place qu'à l'emplacement du client (par exemple, une dépanneuse) ou à la fois à une adresse et sur place (par exemple, une pizzeria avec un espace repas, qui livre également aux clients).
Enums | |
---|---|
BUSINESS_TYPE_UNSPECIFIED |
Uniquement en sortie. Non spécifié. |
CUSTOMER_LOCATION_ONLY |
Propose ses services uniquement à proximité (pas à l'adresse de l'établissement). Si le client passe de CUSTOMER_AND_BUSINESS_LOCATION à CUSTOMER_LOCATION_ONLY, la mise à jour de l'établissement doit inclure le masque de champ storefrontAddress et le laisser vide. |
CUSTOMER_AND_BUSINESS_LOCATION |
Propose ses services sur place et aux alentours. |
Places
Définit l'union de zones représentées par un ensemble de lieux.
Représentation JSON |
---|
{
"placeInfos": [
{
object ( |
Champs | |
---|---|
placeInfos[] |
Zones représentées par des ID de lieu. Limité à 20 lieux. |
PlaceInfo
Définit une zone représentée par un ID de lieu.
Représentation JSON |
---|
{ "placeName": string, "placeId": string } |
Champs | |
---|---|
placeName |
Obligatoire. Nom localisé du lieu. Par exemple, |
placeId |
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 |
Obligatoire. Numéro de téléphone secondaire à afficher dans les extensions de lieu AdWords, à la place du numéro de téléphone principal de l'établissement. |
LatLng
Objet représentant une paire latitude/longitude. Cette valeur est exprimée par deux valeurs 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 |
Latitude en degrés. Elle doit être comprise dans la plage [-90.0, +90.0]. |
longitude |
Longitude en degrés. Elle doit être comprise dans la plage [-180.0, +180.0]. |
OpenInfo
Informations concernant l'état d'ouverture de l'établissement.
Représentation JSON |
---|
{ "status": enum ( |
Champs | |
---|---|
status |
Obligatoire. Indique si l'établissement est actuellement ouvert. Tous les établissements sont ouverts par défaut, sauf si la mise à jour indique qu'ils sont fermés. |
canReopen |
Uniquement en sortie. Indique si cet établissement peut être rouvert. |
openingDate |
Facultatif. Date à laquelle l'établissement a ouvert pour la première fois. Si le jour exact n'est pas connu, seuls le mois et l'année peuvent être indiqués. La date doit être dans le passé ou la date doit être antérieure d'un an au maximum. |
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é fermé définitivement. |
CLOSED_TEMPORARILY |
Indique que l'établissement est fermé temporairement. |
Métadonnées
Autres informations de 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 |
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 |
hasPendingEdits |
Uniquement en sortie. Indique si l'une des propriétés de cet établissement est en attente de modification. |
canDelete |
Uniquement en sortie. Indique si l'établissement peut être supprimé à l'aide de l'API. |
canOperateLocalPost |
Uniquement en sortie. Indique si la fiche peut gérer les posts locaux. |
canModifyServiceList |
Uniquement en sortie. Indique si la fiche peut modifier la liste des services. |
canHaveFoodMenus |
Uniquement en sortie. Indique si la fiche est éligible pour un menu alimentaire. |
canOperateHealthData |
Uniquement en sortie. Indique si l'établissement peut exploiter les données Santé. |
canOperateLodgingData |
Uniquement en sortie. Indique si l'établissement peut utiliser les données de l'hébergement. |
placeId |
Uniquement en sortie. Si cet établissement apparaît sur Google Maps, ce champ est renseigné avec l'ID du lieu. Cet identifiant peut être utilisé dans diverses API Places. Ce champ peut être défini lors des appels Create, mais pas de mise à jour. |
duplicateLocation |
Uniquement en sortie. Ressource d'établissement que cet établissement duplique. |
mapsUri |
Uniquement en sortie. Lien vers le lieu sur Maps. |
newReviewUri |
Uniquement en sortie. Lien vers la page de recherche Google où un client peut laisser un avis sur l'établissement. |
canHaveBusinessCalls |
Uniquement en sortie. Indique si la fiche peut bénéficier des appels d'entreprises. |
hasVoiceOfMerchant |
Uniquement en sortie. Indique si la fiche comporte la voix du marchand. Si cette valeur booléenne est "false", vous devez appeler l'API locations.getVoiceOfMerchantState pour savoir pourquoi l'API Voice of Merchant n'est pas disponible. |
Profil
Toutes les informations liées à la fiche de l'établissement.
Représentation JSON |
---|
{ "description": string } |
Champs | |
---|---|
description |
Obligatoire. Description vocale du lieu qui n'est pas modifiable par les autres utilisateurs. |
RelationshipData
Informations de tous les emplacements parents et enfants associés à celui-ci.
Représentation JSON |
---|
{ "parentLocation": { object ( |
Champs | |
---|---|
parentLocation |
Emplacement parent avec lequel cet emplacement est en relation. |
childrenLocations[] |
Liste des emplacements enfants avec lesquels cet emplacement est en relation. |
parentChain |
Nom de ressource de la chaîne à laquelle cet emplacement appartient. [Comment trouver l'ID de la chaîne] [Locations.SearchChains] |
RelevantLocation
Informations sur un autre lieu associé à l'établissement actuel. La relation peut être de type DEPARTMENT_OF ou INDEPENDENT_ESTABLISHMENT_OF, et l'emplacement spécifié ici peut se trouver de chaque côté (parent/enfant) de l'emplacement.
Représentation JSON |
---|
{
"placeId": string,
"relationType": enum ( |
Champs | |
---|---|
placeId |
Obligatoire. Spécifiez l'emplacement qui se trouve de l'autre côté de la relation par son identifiant de lieu. |
relationType |
Obligatoire. Type de relation. |
RelationType
Relations entre les types à spécifier.
Enums | |
---|---|
RELATION_TYPE_UNSPECIFIED |
Type non spécifié |
DEPARTMENT_OF |
Cela représente la relation entre deux établissements partageant un même espace physique, la même marque, la même direction ou la même entreprise, mais avec des attributs clés différents, comme les horaires d'ouverture ou les numéros de téléphone. Par exemple, la pharmacie Carrefour est un service de vente en gros Carrefour. |
INDEPENDENT_ESTABLISHMENT_IN |
Il s'agit des cas où deux établissements sont situés au même endroit, mais de différentes entreprises (par exemple, Starbucks dans un Safeway et dans un centre commercial). |
MoreHours
Il s'agit des périodes pendant lesquelles un établissement est ouvert pour certains types d'établissement.
Représentation JSON |
---|
{
"hoursTypeId": string,
"periods": [
{
object ( |
Champs | |
---|---|
hoursTypeId |
Obligatoire. Type d'horaires. Les clients doivent appeler {#link businessCategories:BatchGet} afin d'obtenir les types d'horaires acceptés pour les catégories correspondant à leurs établissements. |
periods[] |
Obligatoire. Ensemble des heures d'ouverture de cet établissement. Chaque période correspond à une plage d'heures d'ouverture de l'établissement pendant la semaine. |
ServiceItem
Message décrivant un seul service. Ce champ permet de décrire le type de service fourni par le marchand. Par exemple, le salon de coiffure peut être un service.
Représentation JSON |
---|
{ "price": { object ( |
Champs | |
---|---|
price |
Facultatif. Représente le prix monétaire de l'élément du service. Nous vous recommandons de définir "currencyCode" et les unités lorsque vous incluez un prix. Il s'agit d'un prix fixe pour l'élément 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 |
Facultatif. Ce champ sera défini sur la casse des données de services structurées. |
freeFormServiceItem |
Facultatif. La valeur de ce champ correspond aux données de services au format libre. |
StructuredServiceItem
Représente un service structuré proposé par le marchand. Exemple: toilettes_installation.
Représentation JSON |
---|
{ "serviceTypeId": string, "description": string } |
Champs | |
---|---|
serviceTypeId |
Obligatoire. Le champ |
description |
Facultatif. Description de l'élément de service structuré. Le nombre de caractères est limité à 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 notre structure de données de service. Le marchand saisit manuellement les noms de ces services via une surface de géomarche.
Représentation JSON |
---|
{
"category": string,
"label": {
object ( |
Champs | |
---|---|
category |
Obligatoire. Ce champ représente le nom de la catégorie (l'ID stable de la catégorie). Les éléments |
label |
Obligatoire. Libellés de langue de l'élément. Les noms d'articles ne doivent pas dépasser 140 caractères et les descriptions ne doivent pas dépasser 250 caractères. Ce champ ne doit être défini que pour un élément de service personnalisé. Les types de service standardisés doivent être mis à jour via serviceTypeId. |
Libellé
Libellé à utiliser pour afficher la liste des prix, la section ou l'article.
Représentation JSON |
---|
{ "displayName": string, "description": string, "languageCode": string } |
Champs | |
---|---|
displayName |
Obligatoire. Nom à afficher pour la liste de prix, la section ou l'article. |
description |
Facultatif. Description de la liste de prix, de la section ou de l'article. |
languageCode |
Facultatif. Le code de langue BCP-47 pour lequel ces chaînes s'appliquent. Vous ne pouvez définir qu'un seul ensemble de libellés par langue. |
Monnaie
Représente un montant associé à un type de devise.
Représentation JSON |
---|
{ "currencyCode": string, "units": string, "nanos": integer } |
Champs | |
---|---|
currencyCode |
Code de devise à trois lettres défini par la norme ISO 4217. |
units |
Unités entières du montant. Par exemple, si |
nanos |
Nombre de nano-unités (10^-9) du montant. La valeur doit être comprise entre -999 999 999 et +999 999 999 inclus. Si |
Méthodes |
|
---|---|
|
Crée un établissement qui appartiendra à l'utilisateur connecté. |
|
Liste les établissements pour le compte spécifié. |