REST Resource: accounts.locations

Ressource : Location

Un lieu. Pour obtenir une description détaillée de ces champs, consultez l'article du centre d'aide. Pour obtenir la liste des catégories d'activité valides, consultez le point de terminaison de catégorie.

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. Identifiant Google de cet établissement, sous la forme locations/{locationId}.
languageCode

string

Immuable. Langue de l'établissement. 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'emplacement doit correspondre au nom réel de votre établissement tel que vos clients le connaissent, et tel qu'il est indiqué 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, Categories). N'ajoutez pas d'informations inutiles à votre nom (par exemple, préférez "Google" à "Google Inc. - Mountain View Corporate Headquarters"). N'incluez pas de slogans marketing, de codes de magasin, de caractères spéciaux, d'horaires ou d'état d'ouverture/de fermeture, de numéros de téléphone, d'URL de site Web, d'informations sur les services/produits, de lieu/adresse ou d'itinéraire, ni d'informations sur l'emplacement (par exemple, "Distributeur automatique Chase dans Duane Reade").
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 qui décrivent l'établissement.
storefrontAddress

object (PostalAddress)

Facultatif. 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 renseigner jusqu'à cinq valeurs addressLines dans l'adresse. Ce champ ne doit être défini que pour les établissements disposant d'une vitrine. Ce champ ne doit pas être défini pour les emplacements de type CUSTOMER_LOCATION_ONLY. S'il est défini, toute valeur fournie sera ignorée.
websiteUri

string

Facultatif. URL associée à 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é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. Il s'agit généralement des horaires des jours fériés et d'autres non compris dans les horaires d'ouverture habituels. Ils prennent le pas sur les horaires d'ouverture standards. Ce champ ne peut pas être défini sans horaires d'ouverture habituels.
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é, ce champ décrit la ou les zones desservies par cet é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 présentés aux utilisateurs, et vous seul pouvez les voir. Chaque libellé doit comporter entre 1 et 255 caractères.
adWordsLocationExtensions

object (AdWordsLocationExtensions)

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

object (LatLng)

Facultatif. Latitude et longitude fournies par l'utilisateur. Lorsque vous créez un établissement, ce champ est ignoré si l'adresse indiquée est correctement géocodée. Ce champ n'est affiché en résultat des requêtes 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 modifié que par les clients approuvés.
openInfo

object (OpenInfo)

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

object (Metadata)

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

object (Profile)

Facultatif. Utilisez vos propres mots pour décrire votre établissement, et partagez 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, hôtels, motels, auberges).
relationshipData

object (RelationshipData)

Facultatif. Tous les établissements et toutes les chaînes associés à celui-ci.
moreHours[]

object (MoreHours)

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

object (ServiceItem)

Facultatif. Liste des services proposés par les marchands. Un service peut être une coupe de cheveux, l'installation d'un chauffe-eau, etc. Les services en double seront automatiquement supprimés.

PhoneNumbers

Une collection 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 principaux ou supplémentaires à l'aide du masque de mise à jour. Le format de téléphone international est préférable, 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. Numéro de téléphone permettant de joindre votre établissement le plus directement possible. 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, mais 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 à modifier 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. Autres catégories permettant de décrire votre établissement. Les catégories permettent à vos clients de trouver des résultats précis et spécifiques pour les services qui les intéressent. Afin que les informations sur votre établissement restent toujours précises et pertinentes, veillez à sélectionner le moins de catégories possible pour décrire votre activité principale. Sélectionnez vos catégories le plus précisément possible, tout en veillant à ce qu'elles correspondent bien à votre activité principale.

Catégorie

Catégorie décrivant la nature de l'établissement (et non ses activités). Pour obtenir la liste des ID de catégorie valides et les mappages vers leurs noms lisibles par l'humain, 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. La 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 de la catégorie lisible par l'humain. Cette valeur est définie lors de la lecture de l'établissement. Lorsque vous modifiez l'établissement, vous devez définir l'attribut category_id.
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. Un identifiant stable (fourni par Google) pour ce type de service.
displayName

string

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 d'ouverture habituels.

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

string

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

string

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

string

Uniquement en sortie. Nom à afficher localisé et lisible par l'humain pour le type d'horaires.

PostalAddress

Représente une adresse postale, par exemple pour la distribution du courrier ou les adresses de paiement. Une adresse postale permet à un service postal de livrer des articles à un local, une boîte postale ou un emplacement similaire. Une adresse postale n'est pas destinée à modéliser des emplacements géographiques tels que des routes, des villes ou des montagnes.

En général, une adresse est créée par l'utilisateur ou en important des données existantes, selon le type de processus.

Conseils pour saisir ou modifier une adresse :

  • Utilisez un widget d'adresse prêt pour 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ù ces champs sont utilisés.

Pour en savoir plus sur l'utilisation de ce schéma, consultez 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 de 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 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 de codes postaux, mais lorsqu'ils sont utilisés, ils peuvent déclencher une validation supplémentaire avec d'autres parties de l'adresse (par exemple, la validation de l'État ou du 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'elle est utilisée, la valeur est soit une chaîne telle que "CEDEX", éventuellement suivie d'un nombre (par exemple, "CEDEX 7"), soit un nombre seul, représentant le "code de secteur" (Jamaïque), l'"indicateur de zone de livraison" (Malawi) ou l'"indicateur de bureau de poste" (Côte d'Ivoire).
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. 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, en Suisse, ce champ doit rester vide.
locality

string

Facultatif. Désigne généralement la partie 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 locality vide et utilisez addressLines.
sublocality

string

Facultatif. Sous-localité de l'adresse. Il peut s'agir d'un quartier, d'un arrondissement ou d'un district, par exemple.
addressLines[]

string

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

Étant donné que les valeurs de addressLines ne contiennent pas d'informations sur le type et peuvent parfois contenir plusieurs valeurs dans un même champ (par exemple, "Austin, TX"), il est important que l'ordre des lignes soit clair. L'ordre des lignes d'adresse doit correspondre à l'ordre d'enveloppe du pays ou de la région de l'adresse. Dans les pays où cela peut varier (par exemple, le Japon), address_language est utilisé pour l'expliciter (par exemple, "ja" pour l'ordre du plus grand au plus petit et "ja-Latn" ou "en" pour l'ordre du plus petit au plus grand). 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 se compose d'un regionCode, toutes les informations restantes étant placées dans le addressLines. 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.

Pour gérer des adresses complètement non structurées, nous vous recommandons de créer une adresse ne contenant que regionCode et addressLines, puis de la géocoder (plutôt que d'essayer de deviner quelles parties de l'adresse doivent être 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 pendant lesquelles cet établissement est ouvert. 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 à une plage horaire pendant laquelle l'établissement est ouvert en semaine.

TimePeriod

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

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

enum (DayOfWeek)

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

object (TimeOfDay)

Obligatoire. Les valeurs valides couvrent la plage de 00:00 à 24:00, où 24:00 correspond à minuit à la fin du champ de jour spécifié. Remarque : Dans le mappage JSON Proto3, les valeurs par défaut nulles (00:00) sont omises, ce qui produit {} pour openTime.
closeDay

enum (DayOfWeek)

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

object (TimeOfDay)

Obligatoire. Les valeurs valides couvrent la plage de 00:00 à 24:00, où 24:00 correspond à minuit à la fin du champ de jour spécifié. Remarque : Dans le mappage JSON Proto3, les valeurs nulles par défaut (00:00) sont omises, ce qui produit {} pour closeTime.

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

Heures d'une journée au format 24 heures. Doit être supérieur ou égal à 0 et généralement inférieur ou égal à 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 d'une heure. La valeur doit être supérieure ou égale à 0 et inférieure ou égale à 59.
seconds

integer

Secondes d'une minute. Doit être supérieur ou égal à 0 et généralement inférieur ou égal à 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 supérieure ou égale à 0 et inférieure ou égale à 999 999 999.

SpecialHours

Représente un ensemble de périodes durant lesquelles les horaires d'ouverture d'un établissement ne sont pas les mêmes qu'habituellement.

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 durant laquelle les horaires d'ouverture d'un établissement ne sont pas les mêmes qu'habituellement. 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'à 11h59 le lendemain de la startDate spécifiée. Par exemple, voici des entrées 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 de début de cette période d'horaires d'ouverture exceptionnels.
openTime

object (TimeOfDay)

Facultatif. Les valeurs valides couvrent la plage de 00:00 à 24:00, où 24:00 correspond à minuit à la fin du champ de jour spécifié. Ce champ doit être spécifié si la valeur de closed est "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 valeur par défaut est celle spécifiée dans startDate. S'il est défini, ce champ doit présenter une valeur de date située au moins 1 jour après startDate.
closeTime

object (TimeOfDay)

Facultatif. Les valeurs valides couvrent la plage de 00:00 à 24:00, où 24:00 correspond à minuit à la fin du champ de jour spécifié. Ce champ doit être spécifié si la valeur de closed est "false".
closed

boolean

Facultatif. Si la valeur est "true", endDate, openTime et closeTime sont ignorés, et, pour la date spécifiée dans startDate, on considère que l'établissement est 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 correspond au calendrier grégorien proleptique. 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 nuls.
  • 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. Elle doit être comprise entre 1 et 9 999, ou égale à 0 si vous spécifiez une date sans année.
month

integer

Mois d'une année. Il doit être compris entre 1 et 12, ou égal à 0 si vous spécifiez une année sans mois ni jour.
day

integer

Jour du mois. Il doit être compris entre 1 et 31, et valide pour l'année et le mois, ou égal à 0 si vous spécifiez 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é.
places

object (Places)

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

string

Immuable. Code de région CLDR du pays ou de la région où est basé cet établissement de services de proximité. Pour en savoir plus, consultez 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 et est ignoré dans les autres cas.

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

Si cet établissement nécessite une validation après sa création, l'adresse fournie à des fins de validation doit se trouver 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 propose uniquement des services sur site auprès du client (par exemple, une dépanneuse), ou à la fois dans l'établissement et sur site (par exemple, une pizzeria avec un espace repas qui propose aussi des livraisons).

Enums
BUSINESS_TYPE_UNSPECIFIED Uniquement en sortie. Non spécifié.
CUSTOMER_LOCATION_ONLY Ne propose ses services qu'à proximité de l'établissement (pas à l'adresse professionnelle). Si un établissement passe de CUSTOMER_AND_BUSINESS_LOCATION à CUSTOMER_LOCATION_ONLY, la mise à jour de l'adresse doit inclure le masque de champ storefrontAddress et définir le champ sur "vide".
CUSTOMER_AND_BUSINESS_LOCATION Propose ses services à l'adresse professionnelle et aux alentours.

Lieux

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

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

object (PlaceInfo)

Facultatif. Zones représentées par des ID de lieu. Limité à 20 lieux 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. ID 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 composants 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 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 concernant 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. Tous les établissements sont ouverts par défaut, sauf si le champ est mis à jour pour signaler qu'ils sont fermés.
canReopen

boolean

Uniquement en sortie. Indique si cet é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, il est possible de n'indiquer que le mois et l'année. La date doit être passée ou ne pas dépasser un an dans le futur.

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 a été fermé temporairement.

Métadonnées

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

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,
  "isParticularlyPersonalPlace": boolean
}
Champs
hasGoogleUpdated

boolean

Uniquement en sortie. Indique si l'ID de lieu associé à cet établissement comporte des mises à jour qui doivent être appliquées 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 à valider.
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
(deprecated)

boolean

Uniquement en sortie. Obsolète : ce champ n'est plus renseigné et sera supprimé dans une prochaine version.
canModifyServiceList

boolean

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

boolean

Uniquement en sortie. Indique si la fiche est éligible au menu.
canOperateHealthData

boolean

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

boolean

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

string

Uniquement en sortie. Si cet établissement apparaît sur Google Maps, ce champ correspond à l'ID de lieu de l'établissement. Cet ID peut servir dans différentes API Places.

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

string

Uniquement en sortie. Ressource d'emplacement que cet emplacement duplique.
mapsUri

string

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

string

Uniquement en sortie. Lien vers la page de la recherche Google où un client peut laisser un avis sur l'établissement.
canHaveBusinessCalls

boolean

Uniquement en sortie. Indique si la fiche est éligible aux appels professionnels.
hasVoiceOfMerchant

boolean

Uniquement en sortie. Indique si la fiche dispose de la fonctionnalité Voix du marchand. Si ce booléen est défini sur "false", vous devez appeler l'API locations.getVoiceOfMerchantState pour savoir pourquoi le marchand n'a pas la voix du marchand.
isParticularlyPersonalPlace

boolean

Uniquement en sortie. Indique si l'établissement est classé comme un lieu très personnel. Cela signifie que les fonctionnalités de l'historique des positions sont soumises à des restrictions. Si vous pensez qu'un établissement a été suspendu par erreur, consultez cet article du Centre d'aide.

Profil

Toutes les informations liées au profil de l'établissement.

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

string

Obligatoire. Description de l'établissement de votre point de vue. Aucun autre utilisateur ne peut la modifier.

RelationshipData

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

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

object (RelevantLocation)

Facultatif. Emplacement parent avec lequel cet emplacement est associé.
childrenLocations[]

object (RelevantLocation)

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

string

Facultatif. Nom de ressource de la chaîne à laquelle cet établissement appartient. [How to find Chain ID] [Locations.SearchChains]

RelevantLocation

Informations sur un autre établissement associé à l'établissement actuel. La relation peut être DEPARTMENT_OF ou INDEPENDENT_ESTABLISHMENT_OF, et l'établissement spécifié ici peut être d'un côté ou de l'autre (parent/enfant) de l'établissement.

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

string

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

enum (RelationType)

Obligatoire. Type de relation.

RelationType

Relations de type à spécifier.

Enums
RELATION_TYPE_UNSPECIFIED Type non spécifié
DEPARTMENT_OF Cela représente une relation entre deux établissements qui partagent une zone physique, une même marque/direction/organisation, mais qui ont des attributs clés différents, comme les horaires d'ouverture ou les numéros de téléphone. Par exemple, la pharmacie Costco est un rayon de Costco Wholesale.
INDEPENDENT_ESTABLISHMENT_IN Cela représente les cas où deux établissements sont situés au même emplacement physique, mais appartiennent à des entreprises différentes (par exemple, un Starbucks dans un Safeway, des boutiques dans un centre commercial).

MoreHours

Périodes pendant lesquelles un établissement est ouvert pour certains types d'activités.

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 acceptés pour les catégories de leurs établissements.
periods[]

object (TimePeriod)

Obligatoire. Ensemble d'horaires d'ouverture de l'établissement. Chaque période correspond à une plage horaire pendant laquelle l'établissement est ouvert en 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, "coupe de cheveux" peut être un service.

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of mutually exclusive fields.
}
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 units lorsque vous incluez un prix. Elle sera considérée comme le prix fixe de l'article de service.
L'un des champs suivants doit toujours être défini. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse :
structuredServiceItem

object (StructuredServiceItem)

Facultatif. Ce champ est défini pour les données de services structurées.
freeFormServiceItem

object (FreeFormServiceItem)

Facultatif. Ce champ sera défini en cas de données de services au format libre.
Fin des champs mutuellement exclusifs.

StructuredServiceItem

Représente un service structuré proposé par le marchand. Par exemple : toilet_installation.

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

string

Obligatoire. Le champ serviceTypeId est un identifiant unique fourni par Google, que vous trouverez 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 forme libre proposé par le marchand. Il s'agit de services qui ne sont pas exposés dans le cadre de nos données de service structurées. Le marchand saisit manuellement les noms de ces services à l'aide d'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 (c'est-à-dire son ID stable). category et serviceTypeId doivent correspondre aux combinaisons possibles fournies dans le message Category.
label

object (Label)

Obligatoire. Libellés marqués selon la langue pour l'article. Nous vous recommandons de limiter les noms d'articles à 140 caractères et les descriptions à 250 caractères. Ce champ ne doit être défini que si l'entrée est un élément de service personnalisé. Les types de services standards doivent être mis à jour à l'aide de serviceTypeId.

Libellé

Libellé à utiliser afin d'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 pour lequel 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 la devise à trois lettres défini par la norme ISO 4217.
units

string (int64 format)

Unités entières du montant. Par exemple, si currencyCode est défini sur "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 égal à zéro. 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 égal à zéro. 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

 Liste les établissements du compte spécifié.