Questions fréquentes

En quoi consistent les API Fiche d'établissement Google ?

Les API Fiche d'établissement sont des interfaces de programmation qui permettent aux développeurs de créer des applications pour gérer leur compte Fiche d'établissement et les données sur leurs établissements. Grâce à ces API, les marchands ou leurs représentants peuvent gérer la présentation de leurs données sur Google et contrôler les personnes pouvant les modifier. Les données créées par les utilisateurs (photos, posts et avis, par exemple) peuvent aussi être gérées avec ces API.

Les API Fiche d'établissement offrent presque les mêmes fonctionnalités que l'interface utilisateur des fiches d'établissement, avec quelques fonctionnalités supplémentaires spécifiques aux API. Les mises à jour Google sont effectuées dans les API comme elles le sont dans l'interface utilisateur.

Qui peut accéder aux API Fiche d'établissement Google ?

Les API Fiche d'établissement Google ne sont pas publiques. Les utilisateurs doivent demander l'accès aux API Fiche d'établissement Google pour les utiliser. L'accès aux API Fiche d'établissement Google est accordé à toute personne ou entreprise pouvant justifier d'un intérêt commercial légitime. Voici quelques recommandations pour prouver que votre entreprise est légale:

  • Utilisez une adresse e-mail professionnelle valide, associée au domaine de votre entreprise.
  • Assurez-vous que le site Web de l'entreprise est à jour et actif.

L'accès aux API Fiche d'établissement Google autorise-t-il un utilisateur à interroger toutes les données des fiches d'établissement Google ?

Non. Même si vous avez accès à ces API, vous ne pouvez pas interroger les données d'une fiche d'établissement Google, sauf si vous y avez accès spécifiquement.

Quelles règles s'appliquent aux utilisateurs des API Fiche d'établissement Google ?

Les partenaires doivent respecter les Règles concernant les fiches d'établissement Google ainsi que toutes les Règles et Conditions d'utilisation applicables aux API.

Comment les utilisateurs accèdent-ils aux API Fiche d'établissement Google ?

Pour créer votre première application cliente, vous devez remplir les conditions préalables suivantes :

  1. Obtenir un compte Google
  2. Essayer les fiches d'établissement
  3. Créez un projet dans la console Google APIs.
  4. Demander l'accès à l'API (les demandes sont examinées sous 14 jours)

Comment les utilisateurs peuvent-ils accéder à une API spécifique des API Fiche d'établissement Google ?

Vous devez activer huit API associées à la fiche de l'établissement dans la console Google APIs :

  • API Google My Business 4.9, qui inclut les appels d'API suivants pour ces fonctionnalités importantes :
    • FoodMenus
    • Media
    • Reviews
    • LocalPosts
  • API My Business Account Management
  • API My Business Lodging
  • API My Business Place Actions
  • API My Business Notifications
  • API My Business Verifications
  • API My Business Business Information
  • API My Business Q&A
  • API Business Profile Performance

Si la demande d'accès d'un utilisateur est approuvée, un quota par défaut standard lui est accordé pour les huit API.

Comment l'accès aux API Fiche d'établissement Google fonctionne-t-il ?

L'accès à l'API GBP est accordé au niveau d'un projet Google Cloud. Si un utilisateur A a demandé à accéder à l'API Fiche d'établissement Google pour le projet n° 12345678, l'accès lui est accordé pour ce projet. À ce titre, tout utilisateur (y compris l'utilisateur A) ayant accès au projet Google Cloud pourra appeler les API Fiche d'établissement Google. Pour éviter toute utilisation abusive, les partenaires doivent contrôler l'accès au projet Google Cloud en fonction des besoins.

Avez-vous un résumé des API et des exemples de fonctionnalités ?

Reportez-vous au tableau suivant pour en savoir plus sur les différentes API et leurs fonctionnalités.

API Documentation de référence Exemples de fonctionnalités
API Account Management Documentation
  • gérer l'accès à un établissement ;
  • Permet de créer un compte avec le nom et le type spécifiés sous le compte parent donné.
  • Liste tous les comptes pour l'utilisateur authentifié.
  • Liste les invitations en attente pour le compte spécifié.
  • Permet de déplacer un établissement d'un compte appartenant à l'utilisateur vers un autre compte.
  • Informe l'administrateur sur l'établissement spécifié.
API Business Information Documentation
  • L'API Business Information permet de gérer le cycle de vie de la fiche, et d'ajouter des informations sur l'établissement ou de les gérer dans la FEG.
  • Permet aux marchands d'obtenir, de créer, de mettre à jour ou de supprimer des fiches d'établissement Google.
  • Permet aux marchands d'obtenir ou de mettre à jour les attributs d'une fiche.
  • Permet aux marchands d'obtenir ou de rechercher des chaînes et des catégories de fiches.
API Lodging Documentation
  • Permet de gérer les données d'hébergement (services et règlement, par exemple) des établissements sur Google. Cette API est propre aux établissements qui proposent des services d'hébergement, comme les hôtels. L'API Lodging permet aux développeurs de mettre à jour les attributs d'hébergement d'une fiche d'établissement Google.
API Place Actions Documentation
  • Permet de gérer les liens d'action pour un lieu.
  • Permet de rediriger les utilisateurs pour qu'ils puissent prendre un rendez-vous, réserver une table, commander un repas, etc.
API Notifications Documentation
  • Permet de gérer les paramètres de notification pour les comptes spécifiés.
API Verifications Documentation
  • Lance la procédure de validation d'un établissement.
  • Indique toutes les options de validation éligibles pour un établissement dans une langue spécifique.
API Questions/Réponses Documentation
  • Permet de gérer les questions-réponses d'un établissement.
API Business Profile Performance Documentation
  • Permet aux marchands d'extraire des informations sur les performances de leur fiche d'établissement sur Google.
  • Ces informations incluent les impressions de la fiche d'établissement, les demandes d'itinéraire, les clics d'appel, les clics vers le site Web, les réservations, les commandes de repas, les interactions avec le menu et plus encore.
API Media Documentation
  • Permet aux développeurs d'API d'importer des photos et des vidéos pour une fiche d'établissement.
API Reviews Documentation
  • Permet aux marchands d'obtenir des avis et d'y répondre dans une fiche d'établissement.
API Local Posts Documentation
  • Permet aux marchands d'obtenir, de créer ou de mettre à jour des posts locaux.
API FoodMenus Documentation
  • Permet aux marchands d'obtenir, de créer ou de mettre à jour des menus pour une fiche d'établissement.

Si vous avez encore des questions sur les données auxquelles vous avez accès et/ou sur la façon d'y accéder, utilisez les formulaires suivants pour envoyer une demande :

Comment les partenaires doivent-ils configurer la structure de leur compte pour utiliser les API Fiche d'établissement Google ?

Si vous gérez des fiches pour des établissements en tant que partenaire tiers :

Comment une entreprise peut-elle autoriser un partenaire utilisant l'API Fiche d'établissement Google à gérer sa fiche d'établissement ?

Une entreprise peut accorder l'accès à un partenaire tiers de deux façons :

  • Configuration OAuth : consultez ce guide pour comprendre comment les plates-formes partenaires tierces utilisent les identifiants des marchands afin d'accéder aux données des fiches d'établissement Google et de les modifier pour le compte d'un marchand ou d'un établissement.

  • Accès propriétaire ou gestionnaire:si un partenaire tiers est ajouté en tant que gestionnaire de la fiche d'établissement Google par le marchand, qui doit être le propriétaire principal de la fiche, le partenaire tiers n'a pas besoin d'utiliser les identifiants du marchand pour utiliser les API Fiche d'établissement Google afin d'accéder aux données de la fiche et de les modifier.

    Remarque : Nous recommandons vivement aux partenaires tiers de ne pas s'ajouter eux-mêmes comme propriétaire de la fiche d'établissement Google, mais comme gestionnaire.

Si une entreprise possède 10 établissements ou plus, est-il possible d'effectuer une validation groupée ?

Oui. Vous pouvez demander la validation groupée de 10 fiches ou plus. Une fois validés, les établissements publiés qui appartiennent à une chaîne peuvent être gérés avec les API Fiche d'établissement de la même manière que les autres établissements, à quelques exceptions près. Par exemple, les responsables d'établissements sont traités différemment et peuvent s'ajouter eux-mêmes à des établissements franchisés.

Quelles sont les limites de quota pour les différentes API ?

Les limites de quota standards sont indiquées sur la page Limites d'utilisation. Si vous avez besoin de limites plus élevées, envoyez-nous une demande de quota standard.

Quel quota puis-je demander ?

Le quota est une ressource limitée. L'équipe d'assistance des API Fiche d'établissement Google détermine si vous êtes éligible à une demande d'augmentation du quota en fonction du quota que vous avez utilisé auparavant. Si votre utilisation moyenne du quota est inférieure à 70 % de vos limites actuelles, toute augmentation de ces limites risque de vous être refusée.

Les partenaires des API Fiche d'établissement Google peuvent-ils créer un compte pour réaliser des tests en production ?

Non. Il n'est malheureusement pas possible de créer directement une fiche d'établissement Google fictive en production pour réaliser des tests, que ce soit avec l'UI ou l'API des fiches d'établissement.

La plupart des fiches fictives qui sont créées sont signalées par notre équipe de modération et suspendues. Nous vous conseillons d'utiliser une fiche client et de travailler avec cette fiche en dehors des horaires d'ouverture (à condition de ne modifier aucune information principale, comme le nom, l'adresse ou la catégorie) ou de créer une fiche pour le siège de votre entreprise. Si vous souhaitez tester une réponse de l'API pour valider une fiche ou toute autre action nécessitant une fiche en production, vous pouvez utiliser les réponses de l'API fictive.