Gérer les notifications en temps réel

Dans l'API My Business Notifications, 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 opérations suivantes sur les notifications:

• Récupérer les paramètres de notification
• Modifiez les paramètres de notification.
• Supprimer les paramètres de notification.

Cette fonctionnalité est compatible avec les avis, questions et réponses (nouveaux ou mis à jour), les importations de supports, les mises à jour Google pour examen, les changements d'état des établissements, etc. L'objet NotificationType répertorie et décrit les types de notifications disponibles.

Avant de commencer

Pour utiliser l'API My Business Notifications, enregistrez votre application et obtenez des identifiants OAuth 2.0. Pour savoir comment vous lancer avec l'API, consultez Configuration de base.

Configurer Cloud Pub/Sub

Pour configurer les notifications de l'API avec Cloud Pub/Sub, procédez comme suit:

1. Suivez le guide Cloud Pub/Sub pour configurer votre application.
2. Créez un sujet dans votre projet Cloud Pub/Sub et notez le nom du sujet créé.
3. Accordez au moins les autorisations pubsub.topics.publish à [e-mail].
4. Suivez le guide Présentation des abonnements pour configurer les notifications push ou pull.
5. Pour recevoir des notifications, appelez le point de terminaison accounts.updateNotificationSetting dans l'API My Business Notifications. Dans l'appel, utilisez le nom du sujet que vous avez créé dans Cloud Pub/Sub pour y associer votre compte de fiches d'établissement.
6. (Facultatif) Répétez l'étape 5 pour chaque compte de fiches d'établissement pour lequel vous souhaitez recevoir des notifications.

Récupérer les paramètres de notification

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

HTTP

GET
https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting

Mettre à jour les paramètres de notification

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

HTTP

PATCH
https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting?updateMask={commaSeparatedFieldsToUpdate}

{
  pubsubTopic: your/pubsub/topicName
}

Supprimer les paramètres de notification

L'appel de la méthode accounts.updateNotificationSetting avec un pubsubTopic vide supprime les paramètres de notification Cloud Pub/Sub d'un compte. Le tableau suivant montre comment l'appeler:

HTTP

PATCH
https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting?updateMask=pubsubTopic