管理实时通知

在 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. 请提供至少 pubsub.topics.publish mybusiness-api-pubsub@system.gserviceaccount.com 的权限。
  4. 关注订阅者概览 推送或拉取通知设置指南。
  5. 要接收通知,请调用 accounts.updateNotificationSetting 端点。在通话中,使用主题 您在 Cloud Pub/Sub 中创建的名称,以将您的商家资料账号与该主题相关联。
  6. (可选)对每个要关联的商家资料账号重复第 5 步 接收通知。

检索通知设置

accounts.getNotificationSetting 端点返回 。下表显示了如何调用它:

<ph type="x-smartling-placeholder">
</ph> <ph type="x-smartling-placeholder">
</ph>
HTTP
GET
https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting

更新通知设置

accounts.updateNotificationSetting 端点更新与 Kubernetes 端点相关的 Cloud Pub/Sub 通知设置, 。下表显示了如何调用它:

<ph type="x-smartling-placeholder">
</ph> <ph type="x-smartling-placeholder">
</ph>
HTTP
PATCH
https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting?updateMask={commaSeparatedFieldsToUpdate}

{
  pubsubTopic: your/pubsub/topicName
}

删除通知设置

调用 accounts.updateNotificationSettingpubsubTopic 会从账号中删除 Cloud Pub/Sub 通知设置。 下表显示了如何调用它:

<ph type="x-smartling-placeholder">
</ph> <ph type="x-smartling-placeholder">
</ph>
HTTP
PATCH
https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting?updateMask=pubsubTopic