Gérer la validation

Les fournisseurs qui permettent de gérer les fiches directement sur leur plate-forme peuvent faire valider l'établissement d'un marchand sur leur site. Ainsi, il n'est pas nécessaire de rediriger le marchand vers l'interface utilisateur des fiches d'établissement.

Obtenir l'état actuel

Les utilisateurs peuvent appeler locations.getVoiceOfMerchantState pour un établissement donné afin de récupérer son état actuel. Si la valeur booléenne hasVoiceOfMerchant est true, cela signifie que l'établissement est déjà en règle et qu'aucune autre action n'est requise. Si l'action gain_voice_of_merchant dans la réponse contient verify, vous devez procéder à la validation. Pour en savoir plus, suivez les instructions ci-dessous.

Extraire les options de validation

Les fournisseurs peuvent utiliser la méthode locations.fetchVerificationOptions pour inviter les marchands à sélectionner une méthode de contact préférée dans la liste des méthodes de validation disponibles.

Pour extraire les options de validation, utilisez le code suivant :

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/{locationId}:fetchVerificationOptions

{
  "languageCode": "en"
}

Lancer le processus de validation

Après avoir sélectionné 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 s'affiche.

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

Extraire les validations en cours

L'appel locations.verifications.list récupère 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 :

HTTP
GET
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications

Finaliser une validation en attente

En général, vous devez utiliser un code et la méthode locations.verifications.complete pour finaliser la validation d'un établissement.

Pour finaliser une validation en attente, utilisez le code suivant :

HTTP
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éer un établissement

Avec l'API Fiche d'établissement Business Information, vous pouvez intégrer une fonctionnalité de création d'établissements à votre plate-forme. Lorsque vous demandez aux marchands d'ajouter un établissement, procédez comme suit :

Recueillez les informations concernant l'établissement (comme le nom, l'adresse et la catégorie de l'établissement) auprès du marchand.

  1. Appelez le point de terminaison googleLocations.search.
  2. Fournissez des données sur l'établissement (nom de l'établissement, 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 :

  1. Interrogez les correspondances d'établissement possibles.
  2. Demandez au marchand de choisir le bon emplacement.
  3. Si requestAdminRightsUrl figure dans la réponse d'établissement, aidez le marchand à en demander l'accès et à en devenir propriétaire sur la fiche d'établissement Google.
  4. Si requestAdminRightsUrl n'existe pas, créez un établissement avec l'ID de lieu dans la réponse d'établissement.
  5. 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, puis faites-le valider.

Valider des établissements

Pour lancer la procédure de validation à l'aide de l'API Fiche d'établissement, procédez comme suit :

  1. Appelez la méthode accounts.locations.list pour lister tous les établissements d'un compte Google.
  2. Sélectionnez un établissement à valider.
  3. Appelez la méthode API GetVoiceOfMerchant pour vérifier si cet établissement doit être validé.
  4. Si la réponse indique qu'une validation est requise, appelez fetchVerificationOptions pour obtenir la liste des méthodes disponibles pour valider cet établissement.
  5. Vérifiez que les données de verificationOption incluent l'adresse postale, le numéro de téléphone et l'adresse e-mail corrects.
  6. 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 confirmer que la validation a été lancée, appelez la méthode locations.verifications.list.
  7. Appelez la méthode locations.verification.complete avec le code du marchand.
  8. Appelez la méthode API GetVoiceOfMerchant. Si HasVoiceOfMerchant = 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.

Guide des méthodes de validation pour les partenaires validés