Intégrer des établissements issus de la fiche d'établissement

La fiche d'établissement est un outil sans frais et simple d'utilisation, qui permet aux entreprises et aux organisations de gérer leur présence en ligne sur Google (par exemple, dans la recherche Google et sur Maps).

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

Les établissements gérés dans les fiches d'établissement ont déjà été validés via la procédure de validation des fiches d'établissement. Vous pouvez étendre le flux d'autorisation OAuth de la fiche d'établissement pour intégrer ces entreprises à Business Messages et les valider automatiquement pour leur lancement 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 les messages pour un établissement de votre fiche d'établissement.

Prérequis

Vous devez être un partenaire Fiche d'établissement existant ayant accès aux API Fiche d'établissement Google. Si ce n'est pas le cas, suivez les conditions préalables pour demander l'accès à la fiche d'établissement.

Une fois que vous avez obtenu l'accès à l'API Google Business Profile, suivez les guides de configuration de base et de configuration OAuth avant de continuer.

Activer Business Messages pour un établissement de votre fiche d'établissement validée

Le diagramme suivant montre comment votre service Web peut exploiter la validation de l'emplacement d'une fiche d'établissement pour un agent Business Messages. Pour en savoir plus, consultez les instructions détaillées ci-dessous.

Schéma de validation automatique des agents à l'aide de la validation de la fiche d'établissement

  1. Dans votre flux de consentement OAuth existant, dans lequel un propriétaire de compte de fiche d'établissement vous autorise à appeler les API Fiche d'établissement Google en son nom, modifiez les champs d'application des API pour inclure

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

    Les deux portées sont requises pour valider automatiquement l'agent et les établissements.

  2. Créez un agent avec un displayName correspondant 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 des lieux avec l'API Google Business Profile pour trouver le nom des établissements.

    Pour la correspondance de noms :

    • La casse des caractères n'est pas prise en compte.
    • Le nom complet de l'agent doit correspondre exactement au premier ou aux premiers mots du nom de l'établissement dans le profil d'entreprise. Par exemple, un agent nommé "GBP Bakery" correspond à "Gbp Bakery Mountain View", "Gbp Bakery" et "gbp bakery sunnyvale", mais pas à "Bakery San Francisco".

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

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

    La demande de validation nécessite les coordonnées de la marque. Toutefois, la procédure de validation n'envoie 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 bien effectué cette opération, la sortie de la requête de validation doit immédiatement renvoyer un verificationState de VERIFICATION_STATE_VERIFIED. Si verificationState renvoie une valeur différente, il est probable que vous n'ayez pas utilisé le jeton OAuth approprié lors de la demande ou que l'agent n'ait pas pu être associé à un emplacement de fiche d'établissement.

  5. À l'aide du même jeton OAuth, demandez la validation des établissements pour tous les établissements appartenant à l'établissement dans la fiche d'établissement.

    Comme pour la validation de l'agent, si vous avez bien effectué cette opération, la sortie de la requête de validation doit immédiatement renvoyer un verificationState de VERIFICATION_STATE_VERIFIED. Si verificationState renvoie une valeur différente, il est probable que vous n'ayez pas utilisé le bon jeton OAuth lors de la demande ou que l'établissement associé à la fiche d'établissement ne soit pas revendiqué ni validé.

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

  7. Activez la messagerie pour des lieux spécifiques en lançant les lieux que vous souhaitez rendre disponibles dans la recherche et Maps. Une fois le processus de lancement lancé, les messages de chaque établissement lancé sont disponibles pour les utilisateurs dans un délai de quelques heures.

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