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

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

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

Прежде чем вы начнете

Чтобы использовать API уведомлений My Business, зарегистрируйте свое приложение и получите учетные данные OAuth 2.0. Подробную информацию о том, как начать работу с API, см. в разделе «Базовая настройка» .

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

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

  1. Следуйте руководству Cloud Pub/Sub, чтобы настроить приложение .
  2. Создайте тему в своем проекте Cloud Pub/Sub и запишите название созданной темы.
  3. Предоставьте как минимум разрешения pubsub.topics.publish для адреса mybusiness-api-pubsub@system.gserviceaccount.com.
  4. Следуйте обзорному руководству для подписчиков , чтобы настроить push- или pull-уведомления.
  5. Чтобы получать уведомления, вызовите конечную точку accounts.updateNotificationSetting в API уведомлений My Business. Во время звонка используйте название темы, созданное вами в 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