Questions fréquentes

Que sont 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. Les API permettent aux marchands ou à leurs représentants de gérer la présentation de leurs données sur Google et de contrôler qui peut les cogérer. Les données créées par les utilisateurs (photos, posts et avis, par exemple) peuvent également être gérées via les 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. Les mises à jour Google sont effectuées dans les API de la même manière que pour les utilisateurs de l'interface utilisateur.

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

Les API Fiche d'établissement Google ne sont pas ouvertes au public. Les utilisateurs doivent demander l'accès aux API Fiche d'établissement Google pour les utiliser. Toute personne physique ou entreprise pouvant justifier d'une activité professionnelle pour accéder aux API Fiche d'établissement Google est autorisée à y accéder. Voici quelques recommandations pour démontrer la légalité d'une entreprise:

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

L'accès aux API des fiches d'établissement Google permet-il aux utilisateurs d'interroger les données des fiches d'établissement Google ?

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

Quelles sont les règles applicables pour les utilisateurs de l'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 de l'API.

Comment les utilisateurs accèdent-ils à l'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 dans l'API Fiche d'établissement Google ?

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

  • API Google My Business 4.9, qui inclut les principaux appels d'API de fonctionnalité suivants :
    • 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 attribué pour les huit API.

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

L'accès à l'API Fiche d'établissement Google 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 12345678, l'accès est accordé au projet 12345678. Ainsi, tout utilisateur, y compris l'utilisateur A ayant accès au projet Google Cloud, peut appeler les API Fiche d'établissement Google. Pour éviter tout abus, 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 ?

Consultez le 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 ;
  • Crée un compte avec le nom et le type spécifiés sous le parent donné.
  • Répertorie tous les comptes de l'utilisateur authentifié.
  • Répertorie les invitations en attente pour le compte spécifié.
  • Déplace un établissement d'un compte appartenant à l'utilisateur vers un autre.
  • Met à jour l'administrateur pour l'établissement spécifié.
API Business Information Documentation
  • L'API Business Information permet de gérer le cycle de vie des fiches, et d'ajouter ou de gérer les informations sur l'établissement dans la fiche d'établissement Google.
  • 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 des attributs de profil.
  • Permet aux marchands d'obtenir ou de rechercher des chaînes et des catégories de profils.
API Lodging Documentation
  • Permet de gérer les données d'un établissement (par exemple, ses services et les règles applicables aux établissements sur Google). L'API est spécifique aux entreprises 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 au niveau des établissements.
  • Redirigez les utilisateurs pour qu'ils effectuent des actions, comme prendre un rendez-vous, réserver une table ou commander un repas.
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 Q&A Documentation
  • Permet de gérer les questions et les réponses concernant un établissement.
API Business Profile Performance Documentation
  • Permet aux marchands de récupérer des informations sur les performances de leur fiche d'établissement sur Google.
  • Les insights incluent les impressions d'entreprise, les demandes d'itinéraire, les clics d'appel, les clics vers le site Web, les réservations, les commandes de repas, les interactions sur les menus, etc.
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 via 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 alimentaires pour une fiche d'établissement.

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

Si vous gérez les fiches d'établissements en tant que partenaire tiers:

Comment les entreprises peuvent-elles autoriser un partenaire API de la fiche d'établissement Google à gérer leur fiche d'établissement ?

Les entreprises accordent l'accès à un partenaire tiers de deux manières:

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

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

    Remarque:Nous recommandons vivement aux partenaires tiers de ne pas s'ajouter en tant que propriétaires de la fiche d'établissement Google, mais uniquement de s'ajouter en tant qu'administrateurs.

Si une entreprise compte plus de 10 établissements, peut-on effectuer la validation groupée ?

Oui. Vous pouvez demander la validation groupée de plus de 10 fiches. Après la validation, les établissements publiés appartenant à une chaîne peuvent être gérés via 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 des différentes API ?

Les limites de quota standards sont listées dans Limites d'utilisation. Si vous avez besoin de limites plus élevées, vous pouvez envoyer une demande de quota standard.

Quel quota puis-je demander ?

Le quota est une ressource limitée. L'équipe d'assistance de l'API Fiche d'établissement détermine l'éligibilité de votre demande d'augmentation de quota en confirmant votre utilisation passée du quota. Si l'utilisation moyenne de votre quota est inférieure à 70% de vos limites actuelles, toute augmentation supplémentaire de ces limites peut vous être refusée.

Les partenaires API Fiche d'établissement peuvent-ils créer un compte de test pour la production ?

Non. Malheureusement, il n'existe aucun moyen direct de créer une fausse fiche d'établissement Google en production via l'interface utilisateur ou l'API des fiches d'établissement Google, et de la comparer à celle-ci.

La plupart des fiches fictives créées sont signalées par notre modération et suspendues. Nous vous conseillons soit d'utiliser une fiche de client et de la traiter en dehors des heures d'ouverture (à condition de ne pas modifier les informations principales de la fiche, telles que le nom, l'adresse ou la catégorie), soit de créer une fiche pour le siège social de votre entreprise. Si vous souhaitez tester une réponse d'API pour valider une fiche ou toute autre action nécessitant une fiche de production, vous pouvez utiliser des réponses d'API fictives.