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

Méthodes

delete

 Supprime un établissement.

get

 Renvoie l'établissement spécifié tel qu'il a été défini pour la dernière fois par le marchand.

getAttributes

 Récupère les attributs d'un établissement tels qu'ils ont été définis pour la dernière fois par le marchand.

getGoogleUpdated

 Renvoie l'établissement spécifié tel qu'il apparaît sur Google Maps et dans la recherche Google.

patch

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

updateAttributes

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