В 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 , выполните следующие действия:
- Следуйте руководству Cloud Pub/Sub, чтобы настроить приложение .
- Создайте тему в своем проекте Cloud Pub/Sub и запишите название созданной темы.
- Предоставьте как минимум разрешения
pubsub.topics.publish
для адреса mybusiness-api-pubsub@system.gserviceaccount.com. - Следуйте обзорному руководству для подписчиков , чтобы настроить push- или pull-уведомления.
- Чтобы получать уведомления, вызовите конечную точку
accounts.updateNotificationSetting
в API уведомлений My Business. Во время звонка используйте название темы, созданное вами в Cloud Pub/Sub, чтобы связать свой аккаунт бизнес-профиля с этой темой. - (Необязательно) Повторите шаг 5 для каждой учетной записи бизнес-профиля, для которой вы хотите получать уведомления.
Получить настройки уведомлений
Конечная точка accounts.getNotificationSetting
возвращает текущие настройки уведомлений Cloud Pub/Sub для учетной записи. В следующей таблице показано, как его вызвать:
GET https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting
Обновить настройки уведомлений
Конечная точка accounts.updateNotificationSetting
обновляет настройки уведомлений Cloud Pub/Sub, связанные с учетной записью. В следующей таблице показано, как его вызвать:
PATCH https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting?updateMask={commaSeparatedFieldsToUpdate} { pubsubTopic: your/pubsub/topicName }
Удалить настройки уведомлений
accounts.updateNotificationSetting
с пустой pubsubTopic
удаляет настройки уведомлений Cloud Pub/Sub из учетной записи. В следующей таблице показано, как его вызвать:
PATCH https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting?updateMask=pubsubTopic