Intégrer des établissements à partir de la fiche d'établissement

La fiche d'établissement est un outil sans frais et facile à utiliser qui permet aux entreprises et aux organisations de gérer leur présence en ligne sur Google, y compris dans la recherche et sur Maps.

L'API Google Business Profile fournit une interface permettant de gérer les informations concernant les établissements sur Google. Une entreprise peut accorder l'accès à une autre entreprise via le consentement OAuth pour gérer sa fiche en son nom.

Les établissements gérés via la fiche d'établissement ont déjà été validés via la procédure de validation. Vous pouvez étendre le flux d'autorisation OAuth des fiches d'établissement pour intégrer ces établissements à Business Messages et les valider automatiquement pour qu'ils soient lancés dans Business Messages.

Il s'agit d'une méthode plus évolutive et plus rapide pour lancer Business Messages. Il s'agit du flux recommandé pour activer la messagerie pour un établissement dans une fiche.

Prérequis

Vous devez être un partenaire existant Fiche ayant accès aux API Fiche d'établissement Google. Si ce n'est pas le cas, demandez à y accéder en suivant les conditions préalables pour les fiches d'établissement.

Une fois que vous avez accès à l'API Fiche d'établissement Google, suivez les guides de configuration de base et de configuration OAuth avant de continuer.

Activer Business Messages pour un établissement validé associé à une fiche d'établissement

Le schéma suivant montre comment votre service Web peut utiliser la validation de l'emplacement d'une fiche d'établissement d'une marque pour un agent Business Messages. Pour obtenir des instructions détaillées, consultez les informations ci-dessous.

Diagramme permettant de valider automatiquement les agents à l'aide de la validation de la fiche d'établissement

  1. Dans le flux de consentement OAuth existant où le propriétaire d'un compte de fiches d'établissement vous autorise à appeler les API Fiche d'établissement Google en son nom, modifiez les champs d'application d'API pour inclure

    • https://www.googleapis.com/auth/business.manage
    • https://www.googleapis.com/auth/businesscommunications

    Les deux champs d'application sont requis pour faire valider automatiquement l'agent et les établissements.

  2. Créez un agent avec un identifiant displayName qui correspond au nom d'au moins une des fiches d'établissement Google appartenant aux identifiants OAuth que vous avez obtenus à l'étape précédente. Recherchez les établissements à l'aide de l'API Google Business Profile afin de trouver les noms des établissements.

    Pour établir une correspondance de noms,

    • La casse des caractères n'est pas sensible.
    • Le nom complet de l'agent doit correspondre exactement au premier mot du nom d'établissement de la fiche d'établissement. Par exemple, un agent nommé "GBP Boulangerie" correspond à "Gbp Bakery Mountain View", "Gbp Bakery" et "gbp Baker sunvale", mais pas "Bakery San Francisco".

  3. Pour chaque établissement dans la fiche d'établissement, créez un établissement avec le même placeId. Le placeId d'un établissement associé à une fiche est contenu dans l'objet LocationKey lorsqu'un établissement est récupéré à partir de l'API Fiche d'établissement Google.

  4. Une fois l'agent que vous avez créé et le jeton OAuth obtenu, demandez la validation de l'agent.

    Les coordonnées de la marque sont obligatoires pour la demande de validation. Toutefois, le processus de validation n'enverra pas d'e-mail à la marque si le nom de l'agent correspond au nom de la fiche d'établissement et si vous avez obtenu le jeton OAuth avec les champs d'application appropriés.

    Si vous avez effectué cette opération correctement, le résultat de la requête de validation devrait renvoyer immédiatement une valeur verificationState de VERIFICATION_STATE_VERIFIED. Si verificationState renvoie une valeur différente, vous n'avez probablement pas utilisé le jeton OAuth approprié lors de la requête, ou l'agent n'a pas pu être mis en correspondance avec un établissement dans une fiche.

  5. À l'aide du même jeton OAuth, demandez la validation de l'établissement pour tous les établissements détenus par l'établissement sur la fiche.

    Comme pour la validation de l'agent, si vous avez effectué cette opération correctement, le résultat de la requête de validation devrait immédiatement renvoyer une valeur VERIFICATION_STATE_VERIFIED pour verificationState. Si verificationState renvoie une valeur différente, vous n'avez probablement pas utilisé le bon jeton OAuth lors de la requête, ou l'établissement de la fiche n'est pas un établissement revendiqué et validé.

  6. Lancez l'agent avec le point d'entrée LOCATION.

  7. Activez la messagerie pour des établissements spécifiques en lançant ceux que vous souhaitez rendre disponibles dans la recherche et sur Maps. Une fois le processus de lancement lancé, la messagerie pour chaque lieu lancé est disponible sous quelques heures.

Une fois que vous avez suivi ces étapes, tous les messages des clients sont publiés sur le webhook Business Messages enregistré. Vous devez envoyer des réponses aux consommateurs avec l'API Business Messages.