Управление уведомлениями в режиме реального времени

В My Business Notifications API уведомления публикуются в сервисе Cloud Pub/Sub. После того как вы настроите аккаунт Cloud Pub/Sub и создадите тему, вы сможете выполнять следующие операции с уведомлениями:

Поддерживаются уведомления о новых и обновленных отзывах, вопросах и ответах, загрузках мультимедийных материалов, внесенных сотрудниками Google изменениях в отзывы, изменениях состояния адресов и т. д. В объекте NotificationType содержатся список и описания доступных типов уведомлений.

Подготовка

Чтобы использовать My Business Notifications API, зарегистрируйте свое приложение и получите учетные данные OAuth 2.0. Подробнее о начале работы с API читайте в руководстве по базовой настройке.

Настройка Cloud Pub/Sub

Чтобы настроить уведомления API с использованием Cloud Pub/Sub, выполните следующие действия:

  1. Выполните инструкции из руководства Cloud Pub/Sub по настройке приложения.
  2. Создайте тему в своем проекте Cloud Pub/Sub и запишите ее название.
  3. Предоставьте для mybusiness-api-pubsub@system.gserviceaccount.com хотя бы разрешения pubsub.topics.publish.
  4. Настройте push- или pull-уведомления согласно инструкциям из этого руководства.
  5. Чтобы получать уведомления, вызовите конечную точку accounts.updateNotificationSetting в My Business Notifications API. В вызове укажите название темы, созданной вами в проекте Cloud Pub/Sub, чтобы связать с этой темой свой аккаунт сервиса "Профиль компании".
  6. (Необязательно.) Выполните инструкции из пункта 5 для всех аккаунтов сервиса "Профиль компании", для которых вы хотите получать уведомления.

Получение настроек уведомлений

Конечная точка accounts.getNotificationSetting возвращает текущие настройки уведомлений Cloud Pub/Sub для аккаунта. В таблице ниже показано, как вызвать эту конечную точку:

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

Изменение настроек уведомлений

Конечная точка accounts.updateNotificationSetting обновляет настройки уведомлений Cloud Pub/Sub, связанные с аккаунтом. В таблице ниже показано, как вызвать эту конечную точку:

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

{
  pubsubTopic: your/pubsub/topicName
}

Удаление настроек уведомлений

Вызов accounts.updateNotificationSetting с пустым параметром pubsubTopic удаляет настройки уведомлений Cloud Pub/Sub из аккаунта. В таблице ниже показано, как вызвать эту конечную точку:

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