Google My Business API

L'API Google My Business fournit une interface permettant de gérer les informations des établissements sur Google.

Service: mybusiness.googleapis.com

Pour appeler ce service, nous vous recommandons d'utiliser les bibliothèques clientes fournies par Google. Si votre application doit utiliser vos propres bibliothèques pour appeler ce service, utilisez les informations suivantes lorsque vous effectuez les requêtes API.

Document de découverte

Un document de découverte est une spécification exploitable par un ordinateur qui permet de décrire et de consommer les API REST. Ce document permet de créer des bibliothèques clientes, des plug-ins IDE et d'autres outils qui interagissent avec les API Google. Un même service peut fournir plusieurs documents de découverte. Ce service fournit les documents de découverte suivants :

Point de terminaison du service

Un point de terminaison de service est une URL de base qui spécifie l'adresse réseau d'un service d'API. Un service peut disposer de plusieurs points de terminaison de service. Ce service possède le point de terminaison de service suivant, et tous les URI ci-dessous sont relatifs à ce point de terminaison de service :

  • https://mybusiness.googleapis.com

Ressource REST: v4.accounts

Méthodes
create
(deprecated)		 POST /v4/accounts
Crée un compte avec le nom et le type spécifiés sous le parent indiqué.
deleteNotifications
(deprecated)		 DELETE /v4/{name=accounts/*/notifications}
Efface les paramètres de notification Pub/Sub pour le compte.
generateAccountNumber
(deprecated)		 POST /v4/{name=accounts/*}:generateAccountNumber
Génère un numéro pour ce compte.
get
(deprecated)		 GET /v4/{name=accounts/*}
Récupère le compte spécifié.
getNotifications
(deprecated)		 GET /v4/{name=accounts/*/notifications}
Renvoie les paramètres de notification Pub/Sub pour le compte.
list
(deprecated)		 GET /v4/accounts
Répertorie tous les comptes de l'utilisateur authentifié.
listRecommendGoogleLocations GET /v4/{name=accounts/*}:recommendGoogleLocations
Répertoriez tous les GoogleLocation recommandés pour le compte de fiches d'établissement spécifié.
update
(deprecated)		 PUT /v4/{name=accounts/*}
Met à jour le compte professionnel spécifié.
updateNotifications
(deprecated)		 PUT /v4/{name=accounts/*/notifications}

Définit les paramètres de notification Pub/Sub du compte pour indiquer le sujet pour lequel envoyer des notifications Pub/Sub pour la fiche d'établissement:

  • Nouveaux avis concernant les établissements gérés par le compte.

Ressource REST: v4.accounts.admins

Méthodes
create
(deprecated)		 POST /v4/{parent=accounts/*}/admins
Invite l'utilisateur spécifié à devenir administrateur du compte indiqué.
delete
(deprecated)		 DELETE /v4/{name=accounts/*/admins/*}
Supprime l'administrateur spécifié du compte indiqué.
list
(deprecated)		 GET /v4/{parent=accounts/*}/admins
Répertorie les administrateurs du compte spécifié.
patch
(deprecated)		 PATCH /v4/{name=accounts/*/admins/*}
Met à jour l'administrateur pour l'administrateur de compte spécifié.

Ressource REST: v4.accounts.invitations

Méthodes
accept
(deprecated)		 POST /v4/{name=accounts/*/invitations/*}:accept
Accepte l'invitation spécifiée.
decline
(deprecated)		 POST /v4/{name=accounts/*/invitations/*}:decline
Refuse l'invitation spécifiée.
list
(deprecated)		 GET /v4/{parent=accounts/*}/invitations
Répertorie les invitations en attente pour le compte spécifié.

Ressource REST: v4.accounts.locations

Méthodes
associate POST /v4/{name=accounts/*/locations/*}:associate
Associe un établissement à un ID de lieu.
batchGet POST /v4/{name=accounts/*}/locations:batchGet
Récupère tous les établissements spécifiés dans le compte donné.
batchGetReviews POST /v4/{name=accounts/*}/locations:batchGetReviews
Renvoie la liste paginée des avis pour tous les établissements spécifiés.
clearAssociation POST /v4/{name=accounts/*/locations/*}:clearAssociation
Efface l'association entre un lieu et son ID de lieu.
create POST /v4/{parent=accounts/*}/locations
Crée un objet location appartenant au compte spécifié, puis renvoie cette valeur.
delete DELETE /v4/{name=accounts/*/locations/*}
Supprime un établissement.
fetchVerificationOptions POST /v4/{name=accounts/*/locations/*}:fetchVerificationOptions
Indique toutes les options de validation éligibles pour un établissement dans une langue spécifique.
findMatches POST /v4/{name=accounts/*/locations/*}:findMatches
Recherche toutes les zones géographiques possibles correspondant au lieu spécifié.
get GET /v4/{name=accounts/*/locations/*}
Récupère l'emplacement spécifié.
getFoodMenus GET /v4/{name=accounts/*/locations/*/foodMenus}
Renvoie les menus d'un établissement spécifique.
getGoogleUpdated GET /v4/{name=accounts/*/locations/*}:googleUpdated
Récupère la version mise à jour par Google de l'établissement spécifié.
getHealthProviderAttributes GET /v4/{name=accounts/*/locations/*/healthProviderAttributes}
Renvoie les attributs du fournisseur de santé pour un établissement spécifique.
getServiceList GET /v4/{name=accounts/*/locations/*/serviceList}
Récupère la liste de services spécifiée d'un établissement.
list GET /v4/{parent=accounts/*}/locations
Liste les établissements pour le compte spécifié.
patch PATCH /v4/{name=accounts/*/locations/*}
Met à jour l'établissement spécifié.
reportInsights POST /v4/{name=accounts/*}/locations:reportInsights
Affiche un rapport contenant des insights sur une ou plusieurs métriques par zone géographique.
transfer
(deprecated)		 POST /v4/{name=accounts/*/locations/*}:transfer
Déplace un établissement d'un compte appartenant à l'utilisateur vers un autre compte géré par le même utilisateur.
updateFoodMenus PATCH /v4/{foodMenus.name=accounts/*/locations/*/foodMenus}
Met à jour les menus d'un établissement spécifique.
updateHealthProviderAttributes PATCH /v4/{healthProviderAttributes.name=accounts/*/locations/*/healthProviderAttributes}
Met à jour les attributs du prestataire de santé pour un établissement spécifique.
updateServiceList PATCH /v4/{serviceList.name=accounts/*/locations/*/serviceList}
Met à jour la liste de services spécifiée d'un établissement.
verify POST /v4/{name=accounts/*/locations/*}:verify
Démarre la procédure de validation d'un établissement.

Ressource REST: v4.accounts.locations.admins

Méthodes
create
(deprecated)		 POST /v4/{parent=accounts/*/locations/*}/admins
Invite l'utilisateur spécifié à devenir administrateur de l'établissement indiqué.
delete
(deprecated)		 DELETE /v4/{name=accounts/*/locations/*/admins/*}
Supprime l'administrateur spécifié en tant qu'administrateur de l'établissement spécifié.
list
(deprecated)		 GET /v4/{parent=accounts/*/locations/*}/admins
Répertorie tous les administrateurs de l'établissement spécifié.
patch
(deprecated)		 PATCH /v4/{name=accounts/*/locations/*/admins/*}
Met à jour l'administrateur pour l'administrateur d'établissements spécifié.

Ressource REST: v4.accounts.locations.followers

Méthodes
getMetadata GET /v4/{name=accounts/*/locations/*/followers/metadata}
Permet d'obtenir les paramètres des followers pour un établissement.

Ressource REST: v4.accounts.locations.insuranceNetworks

Méthodes
list GET /v4/{parent=accounts/*/locations/*}/insuranceNetworks
Affiche une liste de tous les réseaux d'assurances acceptés par Google.

Ressource REST: v4.accounts.locations.localPosts

Méthodes
create POST /v4/{parent=accounts/*/locations/*}/localPosts
Crée un post local associé à l'établissement spécifié, puis l'affiche.
delete DELETE /v4/{name=accounts/*/locations/*/localPosts/*}
Supprime un post local.
get GET /v4/{name=accounts/*/locations/*/localPosts/*}
Récupère le post local spécifié.
list GET /v4/{parent=accounts/*/locations/*}/localPosts
Affiche une liste de posts locaux associés à un établissement.
patch PATCH /v4/{name=accounts/*/locations/*/localPosts/*}
Met à jour le post local spécifié et l'affiche.
reportInsights POST /v4/{name=accounts/*/locations/*}/localPosts:reportInsights
Renvoie des insights pour un ensemble de posts locaux associés à une seule fiche.

Ressource REST: v4.accounts.locations.media

Méthodes
create POST /v4/{parent=accounts/*/locations/*}/media
Crée un élément multimédia pour l'établissement.
delete DELETE /v4/{name=accounts/*/locations/*/media/*}
Supprime l'élément multimédia spécifié.
get GET /v4/{name=accounts/*/locations/*/media/*}
Renvoie les métadonnées de l'élément multimédia demandé.
list GET /v4/{parent=accounts/*/locations/*}/media
Renvoie une liste d'éléments multimédias associés à un établissement.
patch PATCH /v4/{name=accounts/*/locations/*/media/*}
Met à jour les métadonnées de l'élément multimédia spécifié.
startUpload POST /v4/{parent=accounts/*/locations/*}/media:startUpload
Génère une MediaItemDataRef pour l'importation de l'élément multimédia.

Ressource REST: v4.accounts.locations.media.customers

Méthodes
get GET /v4/{name=accounts/*/locations/*/media/customers/*}
Renvoie les métadonnées de l'élément multimédia demandé par le client.
list GET /v4/{parent=accounts/*/locations/*}/media/customers
Affiche une liste d'éléments multimédias associés à un établissement pour lesquels des clients ont fourni des informations.

Ressource REST: v4.accounts.locations.questions

Méthodes
create POST /v4/{parent=accounts/*/locations/*}/questions
Ajoute une question pour le lieu spécifié.
delete DELETE /v4/{name=accounts/*/locations/*/questions/*}
Supprime une question spécifique écrite par l'utilisateur actuel.
list GET /v4/{parent=accounts/*/locations/*}/questions
Renvoie la liste paginée de questions et certaines de ses réponses pour un emplacement spécifié.
patch PATCH /v4/{name=accounts/*/locations/*/questions/*}
Met à jour une question spécifique écrite par l'utilisateur actuel.

Ressource REST: v4.accounts.locations.questions.answers

Méthodes
delete DELETE /v4/{parent=accounts/*/locations/*/questions/*}/answers:delete
Supprime la réponse écrite par l'utilisateur actuel à une question.
list GET /v4/{parent=accounts/*/locations/*/questions/*}/answers
Renvoie la liste paginée des réponses à une question spécifiée.
upsert POST /v4/{parent=accounts/*/locations/*/questions/*}/answers:upsert
Crée une réponse ou met à jour la réponse existante rédigée par l'utilisateur pour la question spécifiée.

Ressource REST: v4.accounts.locations.reviews

Méthodes
deleteReply DELETE /v4/{name=accounts/*/locations/*/reviews/*}/reply
Supprime la réponse à l'avis spécifié.
get GET /v4/{name=accounts/*/locations/*/reviews/*}
Renvoie l'avis spécifié.
list GET /v4/{parent=accounts/*/locations/*}/reviews
Renvoie la liste paginée des avis pour l'établissement spécifié.
updateReply PUT /v4/{name=accounts/*/locations/*/reviews/*}/reply
Met à jour la réponse à l'avis spécifié.

Ressource REST: v4.accounts.locations.verifications

Méthodes
complete POST /v4/{name=accounts/*/locations/*/verifications/*}:complete
Effectuez une validation PENDING.
list GET /v4/{parent=accounts/*/locations/*}/verifications
Répertoriez les validations d'un établissement, classées par heure de création.

Ressource REST: v4.attributes

Méthodes
list GET /v4/attributes
Renvoie la liste des attributs disponibles qui seraient disponibles pour un établissement associé à la catégorie principale et au pays indiqués.

Ressource REST: v4.categories

Méthodes
batchGet GET /v4/categories:batchGet
Renvoie une liste de catégories d'activité pour la langue et les ID GConcept fournis.
list GET /v4/categories
Affiche une liste de catégories d'activité.

Ressource REST: v4.chains

Méthodes
get GET /v4/{name=chains/*}
Récupère la chaîne spécifiée.
search GET /v4/chains:search
Recherche la chaîne en fonction de son nom.

Ressource REST: v4.googleLocations

Méthodes
report POST /v4/{name=googleLocations/*}:report
Signalez un GoogleLocation.
search POST /v4/googleLocations:search
Recherche dans tous les emplacements possibles correspondant à la requête spécifiée.

Service: mybusiness.googleapis.com

Pour appeler ce service, nous vous recommandons d'utiliser les bibliothèques clientes fournies par Google. Si votre application doit utiliser vos propres bibliothèques pour appeler ce service, utilisez les informations suivantes lorsque vous effectuez les requêtes API.

Document de découverte

Un document de découverte est une spécification exploitable par un ordinateur qui permet de décrire et de consommer les API REST. Ce document permet de créer des bibliothèques clientes, des plug-ins IDE et d'autres outils qui interagissent avec les API Google. Un même service peut fournir plusieurs documents de découverte. Ce service fournit les documents de découverte suivants :

Point de terminaison du service

Un point de terminaison de service est une URL de base qui spécifie l'adresse réseau d'un service d'API. Un service peut disposer de plusieurs points de terminaison de service. Ce service possède le point de terminaison de service suivant, et tous les URI ci-dessous sont relatifs à ce point de terminaison de service :

  • https://mybusiness.googleapis.com

Ressource REST: v1.media

Méthodes
upload POST /v1/media/{resourceName=**}
POST /upload/v1/media/{resourceName=**}
Importe des fichiers multimédias.