Les fournisseurs qui proposent la gestion des fiches directement sur leur plate-forme peuvent valider l'identité d'un marchand sur leur site. Il n'est donc pas nécessaire de rediriger le marchand vers UI des fiches d'établissement
Obtenir l'état actuel
Les utilisateurs peuvent appeler locations.getVoiceOfMerchantState
sur un établissement pour récupérer son état actuel. Si le
hasVoiceOfMerchant
si la valeur booléenne est true
, cela signifie que l'établissement est déjà en règle et qu'aucune autre action n'est requise de votre part. Sinon, si l'action gain_voice_of_merchant
dans la réponse contient verify
, vous devez terminer la validation. Pour en savoir plus, suivez les instructions ci-dessous.
Extraire les options de validation
Les fournisseurs peuvent utiliser
locations.fetchVerificationOptions
méthode pour inviter les marchands à choisir une méthode de contact à privilégier dans la liste des méthodes disponibles
méthodes de validation.
Pour récupérer les options de validation, utilisez le code suivant:
<ph type="x-smartling-placeholder">POST https://mybusinessverifications.googleapis.com/v1/{locationId}:fetchVerificationOptions { "languageCode": "en" }
Lancer la procédure de validation
Après avoir choisi une méthode de validation, lancez la procédure de validation avec
locations.verify
Au terme de cet appel, l'établissement passe à l'état "validé", ou une erreur est renvoyée.
POST https://mybusinessverifications.googleapis.com/v1/locations/{locationId} :verify // Use only one of the below verification methods // For postcard verification: { "method": "ADDRESS", "languageCode": "en", "addressInput": { "mailerContactName": "Ann Droyd" } } // For phone verification: { "method": "PHONE_CALL", "languageCode": "en", "phoneInput": { "phoneNumber": "800-555-0136" } } // For SMS verification: { "method": "SMS", "languageCode": "en", "phoneInput": { "phoneNumber": "800-555-0136" } } // For email verification: { "method": "EMAIL", "languageCode": "en", "emailInput": { "emailAddress": "ex@google.com" } }
Récupérer les validations en cours
La
locations.verifications.list
permet de récupérer l'historique des demandes de validation et leur état pour l'établissement spécifié dans l'appel.
Pour récupérer toutes les demandes de validation, utilisez le code suivant:
<ph type="x-smartling-placeholder">GET https://mybusinessverifications.googleapis.com/v1/locations/{locationId} /verifications
Finaliser une validation en attente
Un code PIN et les
locations.verifications.complete
est généralement requise pour finaliser la validation d'un établissement.
Pour finaliser une validation en attente, utilisez le code suivant:
<ph type="x-smartling-placeholder">POST https://mybusinessverifications.googleapis.com/v1/locations/{locationId} /verifications/{verificationId}:complete { "pin": "123456" }
Bonnes pratiques de validation de la fiche d'établissement Google avec l'API
Création d'un établissement
Avec l'API Fiche d'établissement Business Information, vous pouvez intégrer votre plate-forme pour proposer une fonctionnalité de création d'établissements. Lorsque vous demandez aux marchands d'ajouter un établissement, procédez comme suit:
Demandez au marchand les informations sur l'établissement, telles que le nom, l'adresse et la catégorie de l'établissement.
- Appelez le point de terminaison
googleLocations.search
. - Fournissez des données de localisation (nom de l'entreprise, catégorie, adresse, numéro de téléphone et site Web, par exemple) dans la requête API.
Vous pouvez également rechercher un établissement correspondant en procédant comme suit:
- Interrogez les correspondances d'établissement possibles.
- Demandez au marchand de choisir le bon emplacement.
- Si
requestAdminRightsUrl
figure dans la réponse d'un établissement, aidez le marchand à en demander l'accès et à en devenir propriétaire sur la fiche d'établissement Google. - Si
requestAdminRightsUrl
n'existe pas, créez un établissement en utilisant l'ID de lieu dans la réponse de l'établissement. - Validez le nouvel établissement.
Remarque:Si votre requête initiale ne renvoie aucune correspondance d'établissement possible, utilisez un ID de lieu vide pour créer un établissement. Validez ensuite ce nouvel établissement.
Validation des établissements
Pour commencer la procédure de validation à l'aide de l'API Fiche d'établissement Google, procédez comme suit:
- Appelez la méthode
accounts.locations.list
pour répertorier tous les établissements d'un compte Google. - Sélectionnez un établissement à valider.
- Appelez la méthode API
GetVoiceOfMerchant
pour vérifier si cet établissement doit être validé. - Si la réponse indique qu'une validation est requise, appelez
fetchVerificationOptions
pour obtenir la liste des méthodes disponibles pour valider cet établissement. - Vérifiez que les données de
verificationOption
incluent l'adresse, le numéro de téléphone et l'adresse e-mail corrects. - Une fois que le marchand a sélectionné la meilleure option de validation disponible, appelez la méthode
locations.verify
pour lancer la validation appropriée. Pour vérifier que la validation est en cours, appelez la méthodelocations.verifications.list.
- Appelez la méthode
locations.verification.complete
avec le code du marchand. - Appelez la méthode API
GetVoiceOfMerchant
. SiHasVoiceOfMerchant = true
, l'établissement a bien été validé.
Remarque:Si la validation AUTO
est disponible pour l'établissement, le marchand n'a pas besoin de suivre la procédure de validation.
Pour en savoir plus sur la validation des fiches d'établissement Google, veuillez consulter cet article d'aide du Centre d'aide.