在 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 通知,请执行以下步骤:
- 按照 Cloud Pub/Sub 指南设置应用。
- 在 Cloud Pub/Sub 项目中创建主题,并记下所创建主题的名称。
- 向 mybusiness-api-pubsub@system.gserviceaccount.com 授予至少
pubsub.topics.publish
权限。 - 按照订阅者概览指南设置推送通知或推送通知。
- 如需接收通知,请调用 My Business Notifications API 中的
accounts.updateNotificationSetting
端点。在调用过程中,使用您在 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 }
删除通知设置
使用空 pubsubTopic
调用 accounts.updateNotificationSetting
会删除帐号中的 Cloud Pub/Sub 通知设置。下表显示了如何调用该方法:
PATCH https://mybusinessnotifications.googleapis.com/v1/accounts/{accountId}/notificationSetting?updateMask=pubsubTopic