Mettez à jour votre intégration de l'API Google Business Profile avant la désactivation des points de terminaison critiques. Consultez le planning d'abandon et les instructions pour éviter toute perturbation à partir d'avril 2022.

Gérer le processus de validation

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Les fournisseurs qui proposent la gestion des 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"
}