管理实时通知

在 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. 为 mybusiness-api-pubsub@system.gserviceaccount.com 授予不低于 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