GoogleLocations

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.

Figure 1. Diagramme "Swimlane" illustrant la propriété des établissements des fiches

Complétez les étapes suivantes pour utiliser l'API GoogleLocations :

  1. Demandez au marchand de vous fournir les données de localisation.

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

  3. Sélectionnez l'établissement correspondant au vôtre. En l'absence de correspondance, appelez accounts.locations.create et passez à l'étape 5.

  4. En fonction de l'état de requestAdminRightsUrl dans la réponse, effectuez les actions suivantes :

    1. 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.
    2. Si requestAdminRightsUrl n'existe pas, appelez accounts.locations.create et créez une fiche qui sera validée ultérieurement.
  5. 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.