REST Resource: 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.

Méthodes

delete

Supprime un établissement.

get

Renvoie l'emplacement spécifié.

getAttributes

Recherche tous les attributs définis pour un lieu donné.

getGoogleUpdated

Récupère la version mise à jour par Google de l'établissement spécifié.

patch

Met à jour l'établissement spécifié.

updateAttributes

Mettez à jour les attributs d'un établissement donné.