Maîtriser l'api google business profile pour vos avis
En bref
- L’API lit les avis de vos fiches vérifiées et permet d’y répondre depuis votre propre outil.
- Avant tout appel, il faut faire approuver votre projet Google Cloud et faire vérifier chaque fiche.
- Développez votre propre intégration seulement pour relier les avis à vos outils internes ou pour fixer vos règles de traitement.
- Sans équipe technique, une plateforme tierce est plus simple : elle gère les appels à votre place.
Sommaire
- Qu’est-ce que l’API Google Business Profile et à quoi sert-elle pour les avis ?
- Accès direct à l’API ou plateforme tierce : laquelle vous faut-il ?
- Combien coûte l’utilisation de l’API Google Business Profile ?
- Accès au projet et accès aux avis : ne pas confondre
- Ce que l’API Google Business Profile ne fait pas
- Comment configurer l’accès à l’API pour vos avis ?
- Foire aux questions
Avec plusieurs points de vente, les avis tombent sur chaque fiche, et chacun attend une réponse. Lire et répondre à la main, fiche après fiche, prend vite un temps considérable.
Faut-il développer sa propre intégration ou passer par un outil ? Cet article vous explique comment accéder à l’API, ce qu’elle permet avec les avis et ce qu’elle coûte.
Qu’est-ce que l’API Google Business Profile et à quoi sert-elle pour les avis ?
L’API Google Business Profile lit les avis d’une fiche vérifiée, sans passer par l’interface Google. Vous obtenez le texte de chaque avis et la réponse déjà publiée, pour les traiter dans votre propre outil.
Elle sert aussi à répondre. La méthode updateReply crée une réponse ou remplace celle qui existe. La méthode deleteReply supprime votre réponse, mais l’avis du client reste visible.
Si vos avis ne s’affichent plus, voyez les causes et les recours avant toute réponse.
Huit fiches, une lecture
Fiche par fiche
Sans l’API, vous ouvrez les huit fiches une à une.
Une seule requête
accounts.locations.batchGetReviews lit les avis des huit établissements vérifiés d’un coup. Une requête peut couvrir jusqu’à 50 établissements.
Les pages suivantes
Les résultats sont paginés : lisez toutes les pages, sinon des avis vous échappent.
Accès direct à l’API ou plateforme tierce : laquelle vous faut-il ?
Développer votre propre intégration
Développer votre propre intégration se justifie surtout dans deux cas. Le premier : relier les avis à vos outils internes, comme un logiciel de gestion ou un tableau de suivi. Le second : définir vos propres règles de traitement des avis.
Sinon, l’effort ne se justifie pas : il faut un projet Google Cloud, une autorisation OAuth et du développement avant de répondre au premier avis. Un outil tiers vous évite cette mise en place.
Passer par une plateforme tierce
Pour choisir entre les deux, voyez le guide Google Business Profile Manager, puis comparez ces trois critères.
| Critère | Accès direct à l’API | Plateforme tierce |
|---|---|---|
| Maîtrise technique | Votre équipe doit savoir écrire les appels à l’API et gérer l’authentification. | Aucun code à écrire : chaque utilisateur autorise la connexion avec son compte Google. |
| Charge de maintenance | Votre équipe corrige le code à chaque évolution et suit les quotas. | Le fournisseur de l’outil gère les appels, et vous n’avez rien à maintenir au quotidien. |
| Délai de mise en route | Il faut développer l’intégration avant de répondre au premier avis. | Vous pouvez centraliser les avis de plusieurs fiches dès la connexion. |
Sans équipe technique pour coder et maintenir les appels, la plateforme est le choix le plus simple. Vous n’avez alors ni code à corriger ni autorisation à gérer vous-même.
Si vous pilotez plusieurs fiches, elle regroupe toutes les réponses dans une seule interface. Comptez à partir de 49 € par mois pour un pack de gestion des avis, et à partir de 149 € HT par mois avec 12 mois d’engagement pour d’autres offres.
Pour comparer ces options selon votre budget, consultez le comparatif de logiciels d’avis clients.
Combien coûte l’utilisation de l’API Google Business Profile ?
L’API Google Business Profile est sans frais d’utilisation pour les utilisateurs enregistrés. Le coût réel se trouve ailleurs : il faut d’abord une demande d’approbation pour votre projet Google Cloud, sans laquelle vous ne pouvez pas l’appeler.
Une fois l’approbation obtenue, la console affiche 300 requêtes par minute. C’est la limite à surveiller, car chaque lecture ou réponse d’avis compte comme une requête.
Le quota peut varier selon l’API, donc vérifiez le chiffre exact de la vôtre dans la console. Pour préparer vos fiches avant de lancer les appels, voyez le guide pour optimiser votre fiche Google Business Profile.
Deux semaines de développement, à 145 € la journée, font environ 1 450 €, sans compter la maintenance de chaque trimestre. Un outil à partir de 49 € par mois coûte 588 € par an. Si ce tarif couvre vos besoins, l’abonnement reste moins cher que le développement pendant plus de deux ans.
Accès au projet et accès aux avis : ne pas confondre
Deux contrôles distincts déterminent ce que l’API peut faire : l’approbation du projet et la vérification de chaque fiche.
| Critère | Approbation du projet | Fiche vérifiée |
|---|---|---|
| Où le voir | Dans la console Google Cloud, à la ligne du quota | Sur la fiche, dans Google Business Profile |
| État attendu | Quota de 300 requêtes par minute : approuvé. Quota de 0 : non approuvé | Fiche vérifiée : l’API lit ses avis et y répond |
| Si elle manque | Le projet n’est pas approuvé, quelle que soit la fiche | Seule cette fiche reste bloquée |
Lancez un appel de lecture des avis sur une fiche donnée. Si la réponse contient le code LOCATION_VERIFICATION_REQUIRED, cette fiche n’est pas vérifiée.
Ce code apparaît quel que soit le projet : le projet peut être approuvé et le code apparaître quand même. Pour répondre aux avis une fois la fiche vérifiée, voyez générateur de réponse aux avis Google.
Ce que l’API Google Business Profile ne fait pas
Plusieurs limites d’accès, de quota et de compte conditionnent l’usage de l’API pour les avis :
- Elle ne supprime pas l’avis d’un client. Elle permet seulement de supprimer la réponse de l’établissement.
- Un dépassement de quota renvoie l’erreur 429 Too Many Requests, ou RESOURCE_EXHAUSTED pour un appel gRPC. Dans ce cas, réduisez ou espacez vos appels, puis reprenez quand les requêtes repassent sous la limite.
- Avec un compte Google Workspace, vérifiez que Google Business Profile est activé pour les utilisateurs concernés. Pour répondre aux avis, demandez à votre administrateur d’activer aussi Google Search et/ou Google Maps.
Des informations personnelles, des propos haineux ou hors sujet ne respectent pas les règles de Google sur les contenus. Relisez donc chaque réponse avant de l’envoyer.
Si vous répondez au nom d’un client, obtenez d’abord son autorisation. Pour une réponse bien formulée, voyez comment répondre à un avis Google.
Comment configurer l’accès à l’API pour vos avis ?
Vérifiez vos prérequis, puis suivez ces étapes :
- Un compte Google, un projet Google Cloud valide et un site web.
- Une fiche vérifiée et active depuis 60 jours au moins, avec votre site inscrit dessus. Si elle est suspendue, voyez comment la rétablir avant de continuer.
- Si vous êtes partenaire, créez un compte d’organisation.
- Dans Google Cloud Console, sélectionnez le projet de l’API et relevez son numéro dans la carte d’informations.
- Envoyez la demande depuis une adresse propriétaire ou gestionnaire de la fiche, en choisissant « Application for Basic API Access ».
Configurer l’accès à l’API
Activez les API Business Profile
Dans le projet Google Cloud, activez-les. Repère : elles figurent dans les API activées.
Configurez l’écran de consentement et les identifiants OAuth
Repère : l’identifiant OAuth est créé.
Lisez les avis avec un jeton business.manage
Envoyez le jeton dans Authorization: Bearer ACCESS_TOKEN. Repère : la réponse liste vos avis.
Publiez une réponse de test
Envoyez un PUT à l’adresse de la réponse, avec votre texte dans comment. Repère : la réponse s’affiche sur la fiche.
Retenez l’essentiel : l’API lit vos avis et permet d’y répondre, à condition que votre projet soit approuvé et que chaque fiche soit vérifiée.
Sans équipe technique pour coder, un outil tiers reste le plus simple. Votre prochain pas : contrôlez l’état de votre projet dans la console Google Cloud, puis celui de chaque fiche.
Foire aux questions
Faut-il savoir programmer pour utiliser l’API Google Business Profile ?
Oui, si vous voulez créer votre propre intégration. Il faut alors configurer OAuth, le système d’autorisation de Google, puis envoyer vos requêtes à l’API. Si vous ne codez pas, une plateforme tierce peut prendre cette partie technique à votre place.
Peut-on supprimer un avis client grâce à l’API Google Business Profile ?
Non. L’API Google Business Profile permet seulement de supprimer votre réponse à un avis, pas l’avis lui-même, qui reste publié. Pour un avis injurieux ou faux, signalez-le à Google depuis la fiche, car l’API ne sert pas à le retirer.
Les avis publiés avant la connexion à l’API sont-ils récupérés ?
Oui. La méthode reviews.list renvoie les avis de la fiche vérifiée, y compris ceux publiés avant votre connexion.
Ils arrivent dans la même liste que les avis récents, sans que vous ayez à les ressaisir. Condition : la fiche doit être vérifiée.
Peut-on utiliser l’API Google Business Profile pour publier une actualité sur une fiche ?
Oui, les API Business Profile permettent de gérer les publications sur vos fiches, par exemple une actualité. Les conditions sont les mêmes que pour les avis : votre projet Google Cloud doit être approuvé, et chaque fiche doit être vérifiée.
