REST Resource: accounts.locations

{
  "primaryPhone": string,
  "additionalPhones": [
    string
  ]
}

string

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

string

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

{
  "primaryCategory": {
    object (Category)
  },
  "additionalCategories": [
    {
      object (Category)
    }
  ]
}

object (Category)

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

object (Category)

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

{
  "name": string,
  "displayName": string,
  "serviceTypes": [
    {
      object (ServiceType)
    }
  ],
  "moreHoursTypes": [
    {
      object (MoreHoursType)
    }
  ]
}

string

Obligatoire. Un identifiant stable (fourni par Google) pour cette catégorie. Cette 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).

string

Uniquement en sortie. Nom lisible de la catégorie. Il est défini lors de la lecture de l'emplacement. Lorsque vous modifiez l'emplacement, category_id doit être défini.

object (ServiceType)

Uniquement en sortie. Liste de tous les types de services disponibles pour cette catégorie d'activité.

object (MoreHoursType)

Uniquement en sortie. Autres types d'horaires disponibles pour cette catégorie d'activité.

{
  "serviceTypeId": string,
  "displayName": string
}

string

Uniquement en sortie. ID stable (fourni par Google) pour ce type de service.

string

Uniquement en sortie. Nom lisible à afficher pour le type de service.

{
  "hoursTypeId": string,
  "displayName": string,
  "localizedDisplayName": string
}

string

Uniquement en sortie. Identifiant stable fourni par Google pour ce type d'horaires.

string

Uniquement en sortie. Nom lisible à afficher en anglais pour le type d'horaires.

string

Uniquement en sortie. Nom à afficher, localisé et intelligible, pour le type d'horaires.

{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}

integer

Révision du 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.

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 les pages https://cldr.unicode.org/ et https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Exemple : "CH" pour la Suisse.

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

string

Facultatif. Code postal de l'adresse. Tous les pays n'utilisent pas ou n'exigent pas de codes postaux, mais lorsqu'ils s'en servent, ils peuvent déclencher une validation supplémentaire avec d'autres parties de l'adresse (par exemple, validation par État/code postal aux États-Unis).

string

Facultatif. Code de tri supplémentaire, spécifique à chaque pays. La plupart des régions ne s'en servent pas. Lorsqu'il est utilisé, sa valeur comprend une chaîne de type CEDEX, éventuellement suivie d'un numéro (par exemple CEDEX 7), ou tout simplement un nombre représentant un "code de secteur" (Jamaïque), un "indicateur de zone de livraison" (Malawi) ou un "indicateur postal" (Côte d'Ivoire, par exemple).

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. Plus précisément, 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, ce champ doit rester vide en Suisse.

string

Facultatif. Fait généralement référence à la 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 le champ de localité vide et utilisez addressLines.

string

Facultatif. Sous-localité de l'adresse. Il peut s'agir, par exemple, de quartiers, d'arrondissements ou de districts.

string

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

Étant donné que les valeurs dans "addressLines" ne contiennent pas d'informations de type et peuvent parfois comprendre plusieurs valeurs dans un seul champ (par exemple, "Austin, TX"), il est important que l'ordre des lignes soit bien clair. L'ordre des lignes d'adresse doit correspondre à l'ordre suivi sur les enveloppes pour le pays/la région de l'adresse. Dans les pays où cet ordre peut varier (par exemple, au Japon), "address_language" est utilisé pour le rendre explicite (par exemple, "ja" pour un ordre décroissant et "ja-Latn" ou "en" pour un ordre croissant). 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 consiste en un code "regionCode" avec toutes les informations restantes placées dans les lignes "adresseLines". 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.

La création d'une adresse contenant uniquement un code "regionCode" et des lignes "addressLines" suivi d'un géocodage est la méthode recommandée pour gérer les adresses complètement déstructurées (plutôt que de deviner quelles parties de l'adresse sont des localités ou des régions administratives).

string

Facultatif. Destinataire. Ce champ peut, dans certaines circonstances, contenir des informations multilignes. Par exemple, il peut comporter la ligne "chez".

string

Facultatif. Nom de l'entreprise.

{
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}

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.

{
  "openDay": enum (DayOfWeek),
  "openTime": {
    object (TimeOfDay)
  },
  "closeDay": enum (DayOfWeek),
  "closeTime": {
    object (TimeOfDay)
  }
}

enum (DayOfWeek)

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

object (TimeOfDay)

Obligatoire. Les valeurs valides sont comprises entre 00:00 et 24:00, où 24:00 correspond à minuit à la fin du champ de jour spécifié.

enum (DayOfWeek)

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

object (TimeOfDay)

Obligatoire. Les valeurs valides sont comprises entre 00:00 et 24:00, où 24:00 correspond à minuit à la fin du champ de jour spécifié.

{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}

integer

Heure de la journée au format 24 heures. Elle doit être comprise entre 0 à 23. Une API peut choisir d'autoriser la valeur "24:00:00" pour des cas tels que l'heure de fermeture des bureaux.

integer

Minutes de l'heure de la journée. Elles doivent être comprises entre 0 à 59.

integer

Secondes de l'heure de la journée. Elles doivent normalement être comprises entre 0 et 59. Une API peut autoriser la valeur 60 si elle autorise les secondes intercalaires.

integer

Fractions de secondes en nanosecondes. La valeur doit être comprise entre 0 et 999 999 999.

{
  "specialHourPeriods": [
    {
      object (SpecialHourPeriod)
    }
  ]
}

object (SpecialHourPeriod)

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

{
  "startDate": {
    object (Date)
  },
  "openTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "closeTime": {
    object (TimeOfDay)
  },
  "closed": boolean
}

object (Date)

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

object (TimeOfDay)

Facultatif. Les valeurs valides sont comprises entre 00:00 et 24:00, où 24:00 correspond à minuit à la fin du champ de jour spécifié. Doit être spécifié si closed est défini sur "false".

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

object (TimeOfDay)

Facultatif. Les valeurs valides sont comprises entre 00:00 et 24:00, où 24:00 correspond à minuit à la fin du champ de jour spécifié. Doit être spécifié si closed est défini sur "false".

boolean

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

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

Année de la date. Doit être comprise entre 1 et 9999, ou 0 pour indiquer une date sans année.

integer

Mois de l'année. La valeur doit être comprise entre 1 et 12, ou égale à 0 pour spécifier une année sans mois ni jour.

integer

Jour du mois. Doit être compris entre 1 et 31, et valide pour l'année et le mois, ou 0 pour indiquer une année seule, ou une année et un mois où le jour n'est pas significatif.

{
  "businessType": enum (BusinessType),
  "places": {
    object (Places)
  },
  "regionCode": string
}

enum (BusinessType)

Obligatoire. Indique le [type] [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType] de l'établissement de services de proximité à domicile.

object (Places)

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

string

Immuable. Code CLDR du pays ou de la région où est située cette zone desservie. Pour en savoir plus, consultez les pages 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 CUSTOMER_LOCATION_ONLY et est ignoré dans les autres cas.

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

Si cet établissement doit être validé après sa création, l'adresse fournie pour la validation doit être située dans cette région, et le propriétaire de l'établissement ou son représentant autorisé doit être en mesure de recevoir du courrier postal à l'adresse de validation fournie.

{
  "placeInfos": [
    {
      object (PlaceInfo)
    }
  ]
}

object (PlaceInfo)

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

{
  "placeName": string,
  "placeId": string
}

string

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

string

Obligatoire. Identifiant du lieu. Doit correspondre à une région. (https://developers.google.com/places/web-service/supported_types#table3)

{
  "adPhone": string
}

string

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

{
  "latitude": number,
  "longitude": number
}

number

Latitude en degrés. Elle doit être comprise dans la plage [-90.0, +90.0].

number

Longitude en degrés. Elle doit être comprise dans la plage [-180.0, +180.0].

{
  "status": enum (OpenForBusiness),
  "canReopen": boolean,
  "openingDate": {
    object (Date)
  }
}

enum (OpenForBusiness)

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

boolean

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

object (Date)

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

{
  "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
}

boolean

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

boolean

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

boolean

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

boolean

Uniquement en sortie. Indique si la fiche peut gérer les posts locaux.

boolean

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

boolean

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

boolean

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

boolean

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

string

Uniquement en sortie. Si ce lieu apparaît sur Google Maps, l'ID du lieu est inséré dans ce champ. Cet ID peut être utilisé dans diverses API Places.

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

string

Uniquement en sortie. Ressource d'établissement dupliquée par cet établissement.

string

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

string

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

boolean

Uniquement en sortie. Indique si la fiche peut recevoir des appels professionnels.

boolean

Uniquement en sortie. Indique si la fiche contient la voix du marchand. Si la valeur booléenne est "false", vous devez appeler l'API locations.getVoiceOfMerchantState pour savoir pourquoi ils ne disposent pas de Voice of Merchant.

{
  "description": string
}

string

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

{
  "parentLocation": {
    object (RelevantLocation)
  },
  "childrenLocations": [
    {
      object (RelevantLocation)
    }
  ],
  "parentChain": string
}

object (RelevantLocation)

Emplacement parent avec lequel cet établissement est en relation.

object (RelevantLocation)

Liste des emplacements enfants avec lesquels cet établissement est en relation.

string

Nom de ressource de la chaîne à laquelle appartient l'établissement. [Comment trouver l'ID de chaîne] [Locations.SearchChains]

{
  "placeId": string,
  "relationType": enum (RelationType)
}

string

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

enum (RelationType)

Obligatoire. Type de la relation.

{
  "hoursTypeId": string,
  "periods": [
    {
      object (TimePeriod)
    }
  ]
}

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.

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.

{
  "price": {
    object (Money)
  },

  // Union field service_item_info can be only one of the following:
  "structuredServiceItem": {
    object (StructuredServiceItem)
  },
  "freeFormServiceItem": {
    object (FreeFormServiceItem)
  }
  // End of list of possible types for union field service_item_info.
}

object (Money)

Facultatif. Représente le prix monétaire de l'élément de service. Nous vous recommandons de définir "currencyCode" et les unités lorsque vous incluez un prix. Il sera traité comme un prix fixe pour l'article du service.

object (StructuredServiceItem)

Facultatif. La casse de ce champ sera définie pour les données de services structurées.

object (FreeFormServiceItem)

Facultatif. Ce champ sera défini pour les données de services de format libre.

{
  "serviceTypeId": string,
  "description": string
}

string

Obligatoire. Le champ serviceTypeId est un identifiant unique fourni par Google, qui se trouve dans ServiceType. Ces informations sont fournies par le service RPC categories.batchGet.

string

Facultatif. Description de l'élément de service structuré. Le nombre maximal de caractères est de 300.

{
  "category": string,
  "label": {
    object (Label)
  }
}

string

Obligatoire. Ce champ représente le nom de la catégorie (identifiant stable de la catégorie). category et serviceTypeId doivent correspondre aux combinaisons possibles fournies dans le message Category.

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. Ce champ ne doit être défini que si l'entrée est un élément de service personnalisé. Les types de services standardisés doivent être mis à jour via serviceTypeId.

{
  "displayName": string,
  "description": string,
  "languageCode": string
}

string

Obligatoire. Nom à afficher de la liste de prix, de la section ou de l'article.

string

Facultatif. Description de la liste de prix, de la section ou de l'article.

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.

{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}

string

Code de devise à trois lettres défini dans la norme ISO 4217.

string (int64 format)

Unités entières du montant. Par exemple, si currencyCode correspond à "USD", une unité correspond à un dollar américain.

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.