REST Resource: locations

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 (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 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 dossiers.

title

string

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, Address ou Categories). N'ajoutez pas d'informations inutiles dans votre nom (par exemple, "Google" peut être préférable à "Google Inc. - Siège social de Mountain View"). N'ajoutez pas de slogans marketing, de codes de magasin, de caractères spéciaux, d'horaires d'ouverture ou d'ouverture, de numéros de téléphone, d'URL de sites Web, d'informations sur les produits/services, d'adresses/d'adresses ou d'itinéraires, ni d'informations sur le périmètre de sécurité (par exemple, "Distributeur de billets Caisse à 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. 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 addressLines dans l'adresse. Ce champ ne doit être défini que pour les établissements qui disposent d'une vitrine. Ce champ ne doit pas être défini pour les établissements de type CUSTOMER_LOCATION_ONLY. 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 individuel plutôt qu'un site Web ou une URL générique qui représentent 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 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

object (ServiceAreaBusiness)

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[]

string

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

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 renvoyé dans les demandes d'obtention 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 les clients approuvés.

openInfo

object (OpenInfo)

Facultatif. Indicateur signalant si l'établissement est actuellement ouvert

metadata

object (Metadata)

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

profile

object (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

object (RelationshipData)

Facultatif. Tous les établissements et la chaîne associés à celui-ci.

moreHours[]

object (MoreHours)

Facultatif. Horaires supplémentaires pour les différents services d'une entreprise ou des clients spécifiques.

serviceItems[]

object (ServiceItem)

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.

Méthodes

delete

Supprime un établissement.

get

Affiche l'emplacement spécifié.

getAttributes

Recherche tous les attributs définis pour un établissement 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é.