L'API GoogleLocations vous permet de vérifier à l'avance si un établissement a déjà été revendiqué dans une fiche d'établissement. Si c'est le cas, vous pouvez ainsi immédiatement demander d'y accéder. De plus, si vous gérez des comptes validés de manière groupée, vous pouvez sélectionner plus précisément les correspondances potentielles à l'avance et éviter la création d'établissements en double.
Le point de terminaison de l'API renvoie une URL indiquant si un établissement a déjà été revendiqué. S'il a été revendiqué, la même URL vous permet de lancer le processus de demande d'accès.
L'image suivante présente le processus permettant de devenir propriétaire d'un établissement.
![](https://developers.google.cn/static/my-business/images/locations1.png?authuser=6&hl=fr)
Complétez les étapes suivantes pour utiliser l'API GoogleLocations
:
- Demandez au marchand de vous fournir les données de localisation.
-
Appelez le point de terminaison
googleLocations.search
. Fournissez les données de localisation dans le corps de l'appel. Vous pouvez également les fournir dans une chaîne de requête, semblable à ce qu'un utilisateur saisit dans la recherche ou dans Maps. Par exemple, "Starbucks 76 av Champs-Élysées, 75008 Paris" est une chaîne de requête.L'API affiche une liste des établissements potentiellement correspondants ainsi que des informations sur chaque établissement, comme
locationName
et l'adresse. - Sélectionnez l'établissement correspondant au vôtre. En l'absence de correspondance, appelez
accounts.locations.create
et passez à l'étape 5. -
En fonction de l'état de
requestAdminRightsUrl
dans la réponse, effectuez les actions suivantes :- Si
requestAdminRightsUrl
existe, un autre utilisateur est propriétaire de la fiche. Redirigez le marchand vers l'URL, afin qu'il lance une demande d'accès et de propriété pour l'établissement existant dans la fiche correspondante. - Si
requestAdminRightsUrl
n'existe pas, appelezaccounts.locations.create
et créez une fiche qui sera validée ultérieurement.
- Si
- Si au cours de ces étapes, vous avez créé des fiches, vous pouvez utiliser les API de validation pour commencer à les valider. Pour en savoir plus, consultez Gérer la validation.