管理实时通知

在 My Business Notifications API 中，系统在 Cloud Pub/Sub 服务中发布通知。设置 Cloud Pub/Sub 并创建主题后，您可以对通知执行以下操作：

• 检索通知设置。
• 更新通知设置。
• 删除通知设置。

支持新的或更新后的评价、问题和回答、媒体内容上传、Google 更新以供评价、营业地点状态更改等。 NotificationType 对象列出并描述了可用的通知类型。

准备工作

如需使用 My Business Notifications API，请注册您的应用并获取 OAuth 2.0 凭据。如需详细了解如何使用该 API，请参阅基本设置。

Cloud Pub/Sub 设置

如需使用 Cloud Pub/Sub 设置 API 通知，请执行以下步骤：

1. 按照 Cloud Pub/Sub 指南设置应用。
2. 在 Cloud Pub/Sub 项目中创建主题，并记下所创建主题的名称。
3. 向 [e-mail] 授予至少 pubsub.topics.publish 权限。
4. 按照订阅者概览指南设置推送通知或推送通知。
5. 如需接收通知，请调用 My Business Notifications API 中的 accounts.updateNotificationSetting 端点。在调用过程中，使用您在 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
}

删除通知设置

使用空 pubsubTopic 调用 accounts.updateNotificationSetting 会删除帐号中的 Cloud Pub/Sub 通知设置。下表显示了如何调用该方法：

HTTP

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