Important : La version 4.7 de l'API a été publiée. Consultez le journal des modifications. Les chaînes d'établissements sont toujours autorisées temporairement à créer des posts en rapport avec le COVID-19.

Gérer le processus de validation

Les fournisseurs qui proposent la gestion des fiches directement sur leur plate-forme peuvent faire valider l'établissement d'un marchand sur leur site. Cela évite ainsi de devoir rediriger le marchand vers l'interface utilisateur Google My Business.

L'image suivante vous donne une vue d'ensemble du processus de validation :

Figure 1 : Diagramme "Swimlane" illustrant le processus de validation des établissements dans Google My Business

Obtenir l'état de validation actuel

Les utilisateurs peuvent appeler accounts.locations.get pour un établissement donné afin de récupérer son état actuel. Si la valeur booléenne location.LocationState.isVerified est true, cela signifie que l'établissement a déjà été validé. Sinon, suivez les étapes décrites dans les sections suivantes afin de faire valider l'établissement.

Extraire les options de validation

Les fournisseurs peuvent utiliser la plate-forme de méthodes accounts.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://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}
:fetchVerificationOptions

{
  "languageCode": "en"
}

Lancer le processus de validation

Après que vous avez sélectionné une méthode de validation, utilisez accounts.locations.verify pour lancer le processus de validation. Au terme de cet appel, l'établissement passe à l'état "validé", ou une erreur est renvoyée.

.
HTTP
POST
https://mybusiness.googleapis.com/v4/accounts/{accountId}/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 accounts.locations.verifications récupère l'état de validation actuel, ainsi que l'historique, pour l'établissement spécifié dans l'appel.

Pour extraire les validations en cours, utilisez le code suivant :

HTTP
GET
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}
/verifications

Finaliser une validation en attente

Dans certains cas, la validation de l'établissement doit se faire à l'aide d'un code et de la méthode accounts.locations.verifications.complete.

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

HTTP
POST
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}
/verifications/{verificationId}:complete

{
  "pin": "123456"
}