REST Resource: accounts.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,
  "locationName": string,
  "primaryPhone": string,
  "additionalPhones": [
    string
  ],
  "address": {
    object (PostalAddress)
  },
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ],
  "websiteUrl": string,
  "regularHours": {
    object (BusinessHours)
  },
  "specialHours": {
    object (SpecialHours)
  },
  "serviceArea": {
    object (ServiceAreaBusiness)
  },
  "locationKey": {
    object (LocationKey)
  },
  "labels": [
    string
  ],
  "adWordsLocationExtensions": {
    object (AdWordsLocationExtensions)
  },
  "latlng": {
    object (LatLng)
  },
  "openInfo": {
    object (OpenInfo)
  },
  "locationState": {
    object (LocationState)
  },
  "attributes": [
    {
      object (Attribute)
    }
  ],
  "metadata": {
    object (Metadata)
  },
  "priceLists": [
    {
      object (PriceList)
    }
  ],
  "profile": {
    object (Profile)
  },
  "relationshipData": {
    object (RelationshipData)
  },
  "moreHours": [
    {
      object (MoreHours)
    }
  ]
}
Champs
name

string

Identifiant Google de cet établissement, au format suivant: accounts/{accountId}/locations/{locationId}

Dans le cas de correspondances, ce champ n'est pas renseigné.

languageCode

string

Langue du lieu. Défini lors de la création et non modifiable.

storeCode

string

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.

locationName

string

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).

primaryPhone

string

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

string

Jusqu'à deux numéros de téléphone (mobile ou fixe, pas de fax) permettant de joindre votre établissement, en plus du numéro de téléphone principal

address

object (PostalAddress)

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.

primaryCategory

object (Category)

Catégorie qui décrit le mieux l'activité principale de l'établissement.

additionalCategories[]

object (Category)

Catégories supplémentaires permettant de décrire votre entreprise. Les catégories permettent à vos clients de 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, tout en veillant à ce qu'elles correspondent bien à votre activité principale.

websiteUrl

string

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)

Horaires d'ouverture de l'établissement

specialHours

object (SpecialHours)

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.

serviceArea

object (ServiceAreaBusiness)

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.

locationKey

object (LocationKey)

Ensemble de clés permettant d'associer cet établissement à d'autres sites Google, tels qu'une page Google+ et des adresses Google Maps.

labels[]

string

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. Limité à 255 caractères (par libellé).

adWordsLocationExtensions

object (AdWordsLocationExtensions)

Informations supplémentaires qui s'affichent dans AdWords.

latlng

object (LatLng)

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é que pour les demandes GET 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. Impossible de mettre à jour ce champ.

openInfo

object (OpenInfo)

Indicateur indiquant si l'établissement est actuellement ouvert.

locationState

object (LocationState)

Uniquement en sortie. Ensemble de valeurs booléennes reflétant l'état d'un établissement.

attributes[]

object (Attribute)

Attributs pour cet établissement.

metadata

object (Metadata)

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

priceLists[]
(deprecated)

object (PriceList)

Obsolète: informations sur les tarifs pour cet emplacement.

profile

object (Profile)

Décrivez votre entreprise avec vos propres mots, et partagez avec les utilisateurs l'histoire unique de votre entreprise et de vos offres.

relationshipData

object (RelationshipData)

Tous les établissements et la chaîne associés.

moreHours[]

object (MoreHours)

Des horaires supplémentaires pour les différents services d'un établissement ou des clients spécifiques.

BusinessHours

Représente les périodes d'ouverture de l'établissement. Contient une collection d'instances TimePeriod.

Représentation JSON
{
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}
Champs
periods[]

object (TimePeriod)

Ensemble des horaires d'ouverture de cet établissement. Chaque période correspond à un intervalle d'heures pendant lequel l'établissement est ouvert en semaine.

TimePeriod

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

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

enum (DayOfWeek)

Indique le day of the week à partir duquel cette période commence.

openTime

string

Heure au format ISO 8601 étendu (hh:mm). Les valeurs valides sont comprises entre 00:00 et 24:00, où 24:00 correspond à minuit à la fin du champ de jour spécifié.

closeDay

enum (DayOfWeek)

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

closeTime

string

Heure au format ISO 8601 étendu (hh:mm). Les valeurs valides sont comprises entre 00:00 et 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

SpecialHours

Représente un ensemble de périodes au cours desquelles les horaires d'ouverture d'un établissement diffèrent des horaires d'ouverture habituels.

Représentation JSON
{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}
Champs
specialHourPeriods[]

object (SpecialHourPeriod)

Liste des exceptions aux horaires d'ouverture habituels de l'établissement.

SpecialHourPeriod

Représente une période unique au cours de laquelle les horaires d'ouverture d'un établissement diffèrent des horaires d'ouverture 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 (Date)
  },
  "openTime": string,
  "endDate": {
    object (Date)
  },
  "closeTime": string,
  "isClosed": boolean
}
Champs
startDate

object (Date)

Date du calendrier à laquelle commence cette période d'horaires d'ouverture exceptionnels.

openTime

string

Durée d'exécution à l'ouverture du startDate à l'ouverture d'un emplacement, exprimée au format ISO 8601 étendu sur 24 heures. (hh:mm). 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 isClosed est défini sur "false".

endDate

object (Date)

Date de fin de cette période d'horaires d'ouverture exceptionnels. Si le champ endDate n'est pas défini, la date spécifiée dans startDate est utilisée par défaut. S'il est défini, ce champ doit être égal ou inférieur à 1 jour après startDate.

closeTime

string

Durée d'exécution à la fermeture d'un établissement à endDate, exprimée au format ISO 8601 étendu sur 24 heures. (hh:mm). 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 isClosed est défini sur "false".

isClosed

boolean

Si la valeur est "true", endDate, openTime et closeTime sont ignorés, et la date spécifiée dans startDate est traitée comme l'établissement fermé toute la journée.

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),

  // Union field coverageArea can be only one of the following:
  "radius": {
    object (PointRadius)
  },
  "places": {
    object (Places)
  }
  // End of list of possible types for union field coverageArea.
}
Champs
businessType

enum (BusinessType)

Indique le type de l'établissement de services de proximité à domicile.

Champ d'union coverageArea. Indique la zone de couverture où l'établissement propose ses services. coverageArea ne peut être qu'un des éléments suivants :
radius

object (PointRadius)

Uniquement en sortie. Zone desservie par cet établissement, centrée autour d'un point.

places

object (Places)

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

BusinessType

Indique si cet établissement propose uniquement des services sur place au domicile du client (par exemple, une dépanneuse) ou à la fois à une adresse et sur place (par exemple, une pizzeria dotée d'un espace repas, qui livre aussi à ses clients).

Enums
BUSINESS_TYPE_UNSPECIFIED Uniquement en sortie. Non spécifié.
CUSTOMER_LOCATION_ONLY Offre un service uniquement aux alentours (pas à l'adresse de l'établissement).
CUSTOMER_AND_BUSINESS_LOCATION Propose un service à l'adresse de l'établissement et aux alentours.

PointRadius

Rayon autour d'un point particulier (latitude/longitude).

Représentation JSON
{
  "latlng": {
    object (LatLng)
  },
  "radiusKm": number
}
Champs
latlng

object (LatLng)

Latitude/Longitude spécifiant le centre d'une zone définie par le rayon.

radiusKm

number

Distance en kilomètres de la zone autour du point.

LatLng

Objet représentant une paire latitude/longitude. Elle 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].

Places

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

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

object (PlaceInfo)

Zones représentées par des ID de lieu. 20 emplacements maximum.

PlaceInfo

Définit une zone représentée par un ID de lieu.

Représentation JSON
{
  "name": string,
  "placeId": string
}
Champs
name

string

Nom localisé du lieu. Par exemple, Scottsdale, AZ.

placeId

string

Identifiant du lieu. Doit correspondre à une région.

LocationKey

Références de clés alternatives/de substitution pour un établissement.

Représentation JSON
{
  "plusPageId": string,
  "placeId": string,
  "explicitNoPlaceId": boolean,
  "requestId": string
}
Champs
plusPageId

string

Uniquement en sortie. Si cet établissement est associé à une page Google+, ce champ est renseigné avec l'ID de la page Google+ de cet établissement.

placeId

string

Si cet établissement a été validé et s'il est associé à Google Maps ou s'il apparaît dans Google Maps, l'ID de lieu est inséré dans ce champ. Cet ID peut être utilisé dans diverses API Places.

Si cet établissement n'est pas validé, ce champ peut être renseigné si l'établissement a été associé à un lieu qui apparaît sur Google Maps.

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

La valeur booléenne explicitNoPlaceId supplémentaire indique si un ID de lieu non défini est intentionnel ou non.

explicitNoPlaceId

boolean

Uniquement en sortie. La valeur "true" indique qu'un identifiant de lieu n'est pas défini, ce qui n'est pas le cas si aucune association n'a encore été effectuée.

requestId

string

Uniquement en sortie. requestId utilisé pour créer cet établissement. Ce champ peut être vide si cet établissement a été créé en dehors de l'API Google My Business ou des établissements des fiches.

AdWordsLocationExtensions

Informations supplémentaires qui s'affichent dans AdWords.

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

string

Numéro de téléphone secondaire à afficher dans les extensions de lieu AdWords au lieu du numéro de téléphone principal de l'établissement.

OpenInfo

Informations sur l'état d'ouverture de l'établissement.

Représentation JSON
{
  "status": enum (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}
Champs
status

enum (OpenForBusiness)

Indique si l'établissement est actuellement ouvert ou non. Tous les établissements sont ouverts par défaut, sauf s'ils sont modifiés comme étant fermés.

canReopen

boolean

Uniquement en sortie. Indique si l'établissement peut être rouvert.

openingDate

object (Date)

Date de la première ouverture de l'établissement. Si le jour exact n'est pas connu, seuls le mois et l'année peuvent être indiqués. La date doit être antérieure à la date du jour ou ne pas être postérieure à plus d'un an.

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é définitivement fermé.
CLOSED_TEMPORARILY indique que l'établissement a été temporairement fermé. Cette valeur ne peut être appliquée qu'aux établissements publiés (c'est-à-dire, locationState.is_publish = true). Lorsqu'ils mettent à jour le champ d'état avec cette valeur, les clients doivent définir explicitement updateMask sur openInfo.status. Aucun autre masque de mise à jour ne peut être défini pendant cet appel de mise à jour. Il s'agit d'une restriction temporaire qui sera bientôt assouplie.

LocationState

Contient un ensemble de valeurs booléennes indiquant l'état d'un établissement.

Représentation JSON
{
  "isGoogleUpdated": boolean,
  "isDuplicate": boolean,
  "isSuspended": boolean,
  "canUpdate": boolean,
  "canDelete": boolean,
  "isVerified": boolean,
  "needsReverification": boolean,
  "isPendingReview": boolean,
  "isDisabled": boolean,
  "isPublished": boolean,
  "isDisconnected": boolean,
  "isLocalPostApiDisabled": boolean,
  "canModifyServiceList": boolean,
  "canHaveFoodMenus": boolean,
  "hasPendingEdits": boolean,
  "hasPendingVerification": boolean,
  "canOperateHealthData": boolean,
  "canOperateLodgingData": boolean
}
Champs
isGoogleUpdated

boolean

Uniquement en sortie. Indique si l'ID de lieu associé à cet établissement comporte des mises à jour.

isDuplicate

boolean

Uniquement en sortie. Indique si l'établissement est un doublon d'un autre établissement.

isSuspended

boolean

Uniquement en sortie. Indique si l'établissement est suspendu. Les utilisateurs finaux ne peuvent pas voir les établissements suspendus dans les produits Google. Si vous pensez qu'il s'agit d'une erreur, consultez cet article du Centre d'aide.

canUpdate

boolean

Uniquement en sortie. Indique si l'établissement peut être mis à jour.

canDelete

boolean

Uniquement en sortie. Indique si l'établissement peut être supprimé à l'aide de l'API Google My Business.

isVerified

boolean

Uniquement en sortie. Indique si l'établissement est validé.

needsReverification

boolean

Uniquement en sortie. Indique si l'établissement doit être de nouveau validé.

isPendingReview

boolean

Uniquement en sortie. Indique si l'examen de l'établissement est en attente.

isDisabled

boolean

Uniquement en sortie. Indique si l'établissement est désactivé.

isPublished

boolean

Uniquement en sortie. Indique si l'établissement est publié.

isDisconnected

boolean

Uniquement en sortie. Indique si l'établissement est déconnecté d'un lieu sur Google Maps.

isLocalPostApiDisabled

boolean

Uniquement en sortie. Indique si accounts.locations.localPosts est désactivé pour cet établissement.

canModifyServiceList

boolean

Uniquement en sortie. Indique si la fiche peut modifier une ServiceList.

canHaveFoodMenus

boolean

Uniquement en sortie. Indique si la fiche peut bénéficier d'un menu.

hasPendingEdits

boolean

Uniquement en sortie. Indique si l'une des propriétés de cet établissement est en attente de modification.

hasPendingVerification

boolean

Uniquement en sortie. Indique si l'établissement présente des demandes de validation en attente.

canOperateHealthData

boolean

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

canOperateLodgingData

boolean

Uniquement en sortie. Indique si l'établissement peut exploiter les données sur l'hébergement.

Attribut

Attribut de lieu. Les attributs fournissent des informations supplémentaires sur un établissement. Les attributs qui peuvent être définis pour un établissement peuvent varier en fonction des propriétés de celui-ci (par exemple, la catégorie). Les attributs disponibles sont déterminés par Google et peuvent être ajoutés et supprimés sans modification de l'API.

Représentation JSON
{
  "attributeId": string,
  "valueType": enum (AttributeValueType),
  "values": [
    value
  ],
  "repeatedEnumValue": {
    object (RepeatedEnumAttributeValue)
  },
  "urlValues": [
    {
      object (UrlAttributeValue)
    }
  ]
}
Champs
attributeId

string

Identifiant de l'attribut. Les ID d'attributs sont fournis par Google.

valueType

enum (AttributeValueType)

Uniquement en sortie. Type de valeur que contient cet attribut. Cela doit être utilisé pour déterminer comment interpréter la valeur.

values[]

value (Value format)

Valeurs de cet attribut. Le type des valeurs fournies doit correspondre à celui attendu pour cet attribut. consultez la section AttributeValueType. Il s'agit d'un champ répété dans lequel plusieurs valeurs d'attribut peuvent être fournies. Les types d'attributs n'acceptent qu'une seule valeur.

repeatedEnumValue

object (RepeatedEnumAttributeValue)

Lorsque le type de valeur de l'attribut est REPEATED_ENUM, cette valeur contient la valeur de l'attribut. Les autres champs de valeurs doivent être vides.

urlValues[]

object (UrlAttributeValue)

Lorsque le type de valeur de l'attribut est URL, ce champ contient la ou les valeurs de cet attribut. Les autres champs de valeurs doivent être vides.

RepeatedEnumAttributeValue

Valeurs d'un attribut avec un valueType défini sur REPEATED_ENUM. Elle se compose de deux listes d'ID de valeur: ceux qui sont définis (true) et ceux qui ne sont pas définis (false). Les valeurs absentes sont considérées comme inconnues. Vous devez spécifier au moins une valeur.

Représentation JSON
{
  "setValues": [
    string
  ],
  "unsetValues": [
    string
  ]
}
Champs
setValues[]

string

Valeurs d'énumération définies.

unsetValues[]

string

Valeurs d'énumération non définies.

UrlAttributeValue

Valeurs d'un attribut avec un valueType correspondant à "URL".

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

string

L'URL.

Métadonnées

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

Représentation JSON
{
  "duplicate": {
    object (Duplicate)
  },
  "mapsUrl": string,
  "newReviewUrl": string
}
Champs
duplicate
(deprecated)

object (Duplicate)

Informations sur l'établissement que cet établissement duplique. Présent uniquement lorsque la valeur de locationState.is_duplicate est "true". Obsolète: nous ne prenons plus en charge les informations détaillées sur les doublons.

mapsUrl

string

Lien vers l'établissement sur Maps.

newReviewUrl

string

Lien vers la page de la recherche Google sur laquelle les clients peuvent laisser un avis sur l'établissement.

Dupliquer

Informations sur l'établissement que cet établissement duplique.

Représentation JSON
{
  "locationName": string,
  "placeId": string,
  "access": enum (Access)
}
Champs
locationName

string

Nom de ressource de l'établissement dupliqué. Renseigné uniquement si l'utilisateur authentifié dispose de droits d'accès à cet établissement et que celui-ci n'est pas supprimé.

placeId

string

ID de l'établissement concerné par ce doublon.

access

enum (Access)

Indique si l'utilisateur a accès à l'établissement dupliqué.

Accès

Niveau d'accès de l'utilisateur à l'établissement dupliqué. Cette propriété remplace la propriété et doit être utilisée à la place.

Enums
ACCESS_UNSPECIFIED Non spécifié.
ACCESS_UNKNOWN Impossible de déterminer si l'utilisateur a accès à l'établissement qu'il duplique.
ALLOWED L'utilisateur a accès à l'établissement qu'il duplique.
INSUFFICIENT L'utilisateur n'a pas accès à l'établissement qu'il duplique.

PriceList

Obsolète: liste d'informations sur le prix des articles. Les listes de prix sont structurées comme une ou plusieurs listes de prix, chacune contenant une ou plusieurs sections présentant un ou plusieurs articles. Par exemple, les listes de prix des repas peuvent correspondre à des menus pour le petit-déjeuner, le déjeuner et le dîner, avec des sections dédiées aux burgers, aux steaks et aux produits de la mer.

Représentation JSON
{
  "priceListId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "sourceUrl": string,
  "sections": [
    {
      object (Section)
    }
  ]
}
Champs
priceListId

string

Obligatoire. Identifiant de la liste de prix. Les ID des listes de prix, des sections et des articles ne peuvent pas être dupliqués dans cet emplacement.

labels[]

object (Label)

Obligatoire. Libellés avec marquage linguistique pour la liste de prix.

sourceUrl

string

URL de la source facultative depuis laquelle la liste de prix a été récupérée. Par exemple, il peut s'agir de l'URL de la page qui a été automatiquement détournée pour renseigner les informations du menu.

sections[]

object (Section)

Obligatoire. Rubriques de cette liste de prix. Chaque liste de prix doit contenir au moins une section.

Libellé

Libellé à utiliser pour 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 auquel ces chaînes s'appliquent. Vous ne pouvez définir qu'un seul ensemble de libellés par langue.

Section

Section de la liste de prix contenant un ou plusieurs articles.

Représentation JSON
{
  "sectionId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "sectionType": enum (SectionType),
  "items": [
    {
      object (Item)
    }
  ]
}
Champs
sectionId

string

Obligatoire. ID de la section. Les ID des listes de prix, des sections et des articles ne peuvent pas être dupliqués dans cet emplacement.

labels[]

object (Label)

Obligatoire. Libellés de la section avec marquage de la langue. Nous recommandons de ne pas dépasser 140 caractères pour les noms de sections et les descriptions. Veuillez indiquer au moins un ensemble d'étiquettes.

sectionType

enum (SectionType)

Facultatif. Type de la section de la liste de prix actuelle. La valeur par défaut est FOOD.

items[]

object (Item)

Articles inclus dans cette section de la liste de prix.

SectionType

Type de section.

Enums
SECTION_TYPE_UNSPECIFIED Non spécifié.
FOOD La section contient des éléments qui représentent des aliments.
SERVICES La section contient des éléments qui représentent des services.

Élément

Un seul élément de liste. Chaque variante d'un article de la liste de prix doit avoir son propre article avec ses propres données tarifaires.

Représentation JSON
{
  "itemId": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "price": {
    object (Money)
  }
}
Champs
itemId

string

Obligatoire. ID de l'article. Les ID des listes de prix, des sections et des articles ne peuvent pas être dupliqués dans cet emplacement.

labels[]

object (Label)

Obligatoire. Libellés de l'élément avec marquage de la langue. Nous recommandons de ne pas dépasser 140 caractères pour les noms d'éléments et 250 caractères pour les descriptions. Veuillez indiquer au moins un ensemble d'étiquettes.

price

object (Money)

Facultatif. Prix de l'article

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 devise à trois lettres défini dans la norme ISO 4217.

units

string (int64 format)

Unités entières du montant. Par exemple, si currencyCode correspond à "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 nul. 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 nul. Par exemple, -1,75 $ est représenté par units=-1 et nanos=-750 000 000.

Profil

Toutes les informations concernant le profil de l'établissement.

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

string

Description du lieu de votre propre voix, non modifiable par les autres utilisateurs.

RelationshipData

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

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

string

Nom de ressource de la chaîne à laquelle appartient l'établissement. How to find Chain ID

MoreHours

Périodes d'ouverture pour certains types d'entreprises.

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 d'ouverture acceptés pour les catégories de leurs établissements.

periods[]

object (TimePeriod)

Obligatoire. Ensemble des horaires d'ouverture de cet établissement. Chaque période correspond à un intervalle d'heures pendant lequel l'établissement est ouvert pendant la semaine.

Méthodes

associate

Associe un établissement à un ID de lieu.

batchGet

Récupère tous les établissements spécifiés dans le compte donné.

batchGetReviews

Affiche la liste paginée des avis pour tous les établissements spécifiés.

clearAssociation

Efface une association entre un établissement et son ID de lieu.

create

Crée un objet location appartenant au compte spécifié, puis l'affiche.

delete

Supprime un établissement.

fetchVerificationOptions

Indique toutes les options de validation éligibles pour un établissement dans une langue spécifique.

findMatches

Recherche tous les lieux possibles correspondant à l'établissement spécifié.

get

Récupère l'emplacement spécifié.

getFoodMenus

Affiche les menus d'un lieu spécifique.

getGoogleUpdated

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

getHealthProviderAttributes

Affiche les attributs du fournisseur de santé d'un lieu spécifique.

getServiceList

Permet d'obtenir la liste des services spécifiés pour un établissement.

list

Répertorie les établissements pour le compte spécifié.

patch

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

reportInsights

Affiche un rapport contenant des insights sur une ou plusieurs métriques par établissement.

transfer
(deprecated)

Permet de déplacer un établissement d'un compte appartenant à l'utilisateur vers un autre compte qu'il gère.

updateFoodMenus

Met à jour les menus d'un lieu spécifique.

updateHealthProviderAttributes

Met à jour les attributs du prestataire de santé d'un lieu spécifique.

updateServiceList

Met à jour la liste de services spécifiée d'un établissement.

verify

Lance la procédure de validation d'un établissement.