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.

Gérer les notifications en temps réel

Dans l'API Google My Business, les notifications sont publiées dans le service Cloud Pub/Sub. Après avoir configuré Cloud Pub/Sub et créé un sujet, vous pouvez effectuer les tâches suivantes concernant les notifications :

Cette fonctionnalité peut être utilisée pour les avis, les questions et les réponses (nouveaux ou mis à jour), les importations de supports, les mises à jour Google pour examen, les changements apportés à l'état des établissements, etc. L'objet NotificationType répertorie et décrit les différents types de notification disponibles.

Avant de commencer

Pour utiliser l'API Google My Business, enregistrez votre application et obtenez des identifiants OAuth 2.0. Pour plus de détails sur la manière de vous lancer avec l'API, consultez la section Configuration de base.

Configurer le service Cloud Pub/Sub

Pour configurer les notifications envoyées par l'API Google My Business avec Cloud Pub/Sub, procédez comme suit :

  1. Configurez votre application en suivant les instructions du guide Cloud Pub/Sub.
  2. Créez un sujet dans votre projet Cloud Pub/Sub et notez son nom.
  3. Accordez au minimum des autorisations pubsub.topics.publish à mybusiness-api-pubsub@system.gserviceaccount.com.
  4. Pour configurer des notifications push ou pull, suivez le guide Présentation des abonnements.
  5. Pour recevoir des notifications, appelez le point de terminaison accounts.updateNotifications dans l'API Google My Business. Pour associer votre compte GMB au sujet que vous avez créé dans Cloud Pub/Sub, utilisez le nom du sujet dans l'appel.
  6. (Facultatif) Répétez l'étape 5 pour chaque compte Google My Business pour lequel vous souhaitez recevoir des notifications.

Récupérer les paramètres de notification

Le point de terminaison accounts.getNotifications renvoie les paramètres de notification Cloud Pub/Sub actuels pour un compte donné. Le tableau suivant montre comment l'appeler en langage HTTP et Java :

HTTP
GET
https://mybusiness.googleapis.com/v4/accounts/{accountId}/notifications
Java

La fonction suivante utilise Mybusiness.Accounts.getNotifications pour renvoyer les données pour la notification des comptes.

/**
 * Demonstrates getting notification data.
 * @param name The name (account/`account_id`/notifications) for the notification to retrieve.
 * @return response The notification data.
 */
private static GetNotifications getNotifications(String name) throws Exception {
  Mybusiness.Accounts.getNotifications sub =

mybusiness.accounts().getNotifications(name);
  GetNotifications response = sub.execute();

  return response;
}

Mettre à jour les paramètres de notification

Le point de terminaison accounts.updateNotifications met à jour les paramètres de notification Cloud Pub/Sub associés à un compte. Le tableau suivant montre comment l'appeler en langage HTTP et Java :

HTTP
PUT
https://mybusiness.googleapis.com/v4/accounts/{accountId}/notifications

{
  name: your/pubsub/topicName
}
Java

La fonction suivante utilise Mybusiness.Accounts.Locations.Reviews.Get.

/**
 * Demonstrates getting a review by name.
 * @param reviewName The name (resource path) of the review to retrieve.
 * @return Account The requested review.
 */
private static Review getReview(String reviewName) throws Exception {
Mybusiness.Accounts.Locations.Reviews.Get review =

mybusiness.accounts().locations().reviews().get(reviewName);
  Review response = review.execute();

  return response;
}

Supprimer les paramètres de notification

Le point de terminaison accounts.deleteNotifications supprime d'un compte les paramètres de notification Cloud Pub/Sub. Le tableau suivant montre comment l'appeler en langage HTTP et Java :

HTTP
DELETE
https://mybusiness.googleapis.com/v4/accounts/{accountId}/notifications
Java

La fonction suivante utilise Mybusiness.Accounts.DeleteNotifications.

/**
 * Demonstrates deleting the Google Cloud Pub/Sub settings.
 * @param notificationName The name (account/`account_id`/notifications) for the notification settings to delete.
 * @return The deleted notification setting.
 */
private static DeleteNotifications deleteNotifications(String notificationName) throws Exception {
  Mybusiness.Accounts.DeleteNotifications toDelete =

mybusiness.accounts().deleteNotifications(notificationName);
  DeleteNotification response = toDelete.execute();

  return response;
}