Important : La version 4.7 de l'API a été publiée. Consultez le journal des modifications. Les chaînes d'établissements sont toujours autorisées temporairement à créer des posts en rapport avec le COVID-19.

Établissements

Les établissements peuvent être gérés directement par leur propriétaire, ou par une agence ou un tiers.

Propriétaires d'établissements

Pour partager l'accès à un grand nombre d'établissements avec différentes personnes, vous pouvez créer des groupes d'établissements. Les propriétaires d'établissements qui ne gèrent que quelques établissements n'ont pas besoin de créer des groupes d'établissements. En revanche, si vous gérez un grand nombre d'établissements, ou si vous partagez actuellement votre nom d'utilisateur et votre mot de passe avec d'autres utilisateurs, nous vous recommandons d'utiliser des groupes d'établissements afin de travailler ensemble de manière plus sécurisée.

Agences et tiers

Si votre client dispose déjà d'un compte Google My Business, il peut ajouter votre compte d'agence en tant qu'administrateur à ses établissements individuels ou à son groupe d'établissements. S'ils ne possèdent pas encore de compte Google My Business, ils peuvent en créer un (ainsi qu'un groupe d'établissements si nécessaire), puis ajouter votre agence en tant qu'administrateur.

Un tiers ne doit pas demander un accès à l'API au nom de son client. C'est au client d'effectuer la demande, s'il a besoin d'un accès. Un seul ID de projet est utilisé pour l'ensemble de l'application du client. Lorsqu'un client vous invite à rejoindre un groupe d'établissements existant, vous pouvez accéder à son compte via votre jeton OAuth2.0 généré par le système.

Tests et validation des établissements

Si vous êtes propriétaire de plus de 10 établissements au sein de la même entreprise, vous devez les faire valider individuellement ou via la validation groupée.

Un seul projet par entreprise peut être autorisé à accéder à l'API Google My Business. Les tests concernant des établissements non validés doivent être effectués dans votre projet principal.

Gérer les fiches

L'API Google My Business vous permet de consulter l'état de votre fiche, ainsi que toute modification apportée par Google.

Au niveau de l'API, les champs obligatoires pour les fiches sont identiques à ceux de l'interface utilisateur de Google My Business. Pour en savoir plus, consultez les Consignes à suivre concernant la représentation de votre établissement sur Google.

Il est possible que les modifications que vous apportez avec l'API Google My Business ne soient pas immédiatement répercutées. Si vous modifiez des établissements non validés, les modifications n'apparaissent que dans l'interface Google My Business. Vous pouvez utiliser des établissements validés ou non validés pour gérer les extensions de lieu Google Ads.

Les modifications apportées aux établissements validés peuvent apparaître dans d'autres produits Google. La fiche modifiée peut faire l'objet d'un examen afin de vérifier qu'elle respecte les Consignes relatives à la qualité de Google My Business, ainsi que le Règlement relatif au contenu et au comportement de l'utilisateur de Google.

Horaires d'ouverture exceptionnels

Google tient à jour une liste de jours fériés sur Google, qui sont considérés comme des jours fériés probables. Google Maps et la recherche avertissent les utilisateurs que les horaires d'ouverture d'un établissement peuvent différer à ces dates. Vous pouvez définir des horaires d'ouverture exceptionnels pour informer vos clients de vos heures ouvrées pendant ces périodes.

Latitude et longitude

Lors de la configuration de votre fiche, il est possible que vous deviez fournir à Google la latitude et la longitude de nouveaux établissements, afin qu'ils puissent être placés sur la carte. Lorsque vous créez une fiche, n'incluez pas la latitude et la longitude par défaut. En effet, nous n'utilisons ces coordonnées que si nous ne parvenons pas à localiser une adresse. Si elles sont incluses dans des appels de mise à jour ultérieurs pour des établissements existants, elles ne seront pas prises en compte.

Attributs

Vous pouvez utiliser l'API pour fournir des attributs supplémentaires sur votre entreprise au-delà des informations principales fournies via Google My Business. Pour en savoir plus, consultez les Consignes à suivre concernant la représentation de votre établissement sur Google.

Les attributs sont basés sur la catégorie d'activité. Par exemple, un attribut pour un restaurant pourrait être "petit-déjeuner inclus". La méthode attributes.list permet d'obtenir une liste d'attributs pour une catégorie ou un pays donnés.

Si vous les mettez à jour, les attributs risquent de ne plus apparaître sur les plates-formes Google, telles que Maps ou la recherche. Toutefois, si vous fournissez des attributs, vous aidez Google à développer de futures expériences de recherche à proximité, à faire correspondre votre fiche avec des recherches pertinentes, et à mieux comprendre votre entreprise.

Si vous gérez des attributs Google Hotel, consultez les API Google Hotel pour connaître la marche à suivre.