商家资料是一款简单易用的免费工具,可供商家和组织在各种 Google 产品和服务(包括 Google 搜索和 Google 地图)中管理自己的在线品牌形象。
Google Business Profile API 提供了一个用于在 Google 上管理营业地点信息的接口。商家可以通过 OAuth 同意页面来授权其他商家代表其管理商家资料。
商家资料中的受管理商家已通过商家资料验证流程完成验证。您可以扩展商家资料 OAuth 同意流程,指引这些商家开始使用 Business Messages,并在 Business Messages 上自动对其进行验证以便启动该功能。
这是一种更具推广性且更快的 Business Messages 启动方法,也是一种为商家资料营业地点启用消息功能的推荐流程。
前提条件
您必须是有权访问 Google Business Profile API 的现有商家资料合作伙伴。如果您不是,请按照商家资料前提条件申请访问权限。
获得 Google Business Profile API 的访问权限后,请按照其基本设置和 OAuth 设置指南操作,然后再继续。
为已通过验证的商家资料营业地点启用 Business Messages
下图展示了您的网络服务可以如何将品牌的商家资料营业地点验证功能用于 Business Messages 代理。有关详细说明,请参阅下文。
在商家资料帐号所有者授权您代表其调用 Google Business Profile API 的现有 OAuth 同意流程中,更新该 API 的范围以包含
- https://www.googleapis.com/auth/business.manage
- https://www.googleapis.com/auth/businesscommunications
必须同时具备这两个范围才能成功验证代理和营业地点。
创建一个代理,使其
displayName
与您在上一步中获得的 OAuth 凭据拥有的至少一个 Google 商家资料详情的名称相匹配。使用 Google Business Profile API 查询营业地点,以查找商家名称。在名称匹配方面,请注意:
- 字符不区分大小写。
- 代理的全名必须与商家资料营业地点名称中的一个或多个字词完全匹配。例如,名为“GBP Bakery”的代理与“Gbp Bakery Mountain View”“Gbp Bakery”和“gbp bakery sunnyvale”匹配,但与“Bakery San Francisco”不匹配。
对于商家资料中的每个营业地点,使用相同的
placeId
创建营业地点。从 Google Business Profile API 检索营业地点时,商家资料营业地点的placeId
包含在LocationKey
对象中。使用您创建的代理和所获取的 OAuth 令牌,请求代理验证。
验证请求需要提供品牌联系信息。但是,如果代理名称与商家资料名称相符,并且您获得的 OAuth 令牌具有正确的范围,那么验证流程不会向品牌发送电子邮件。
如果您操作正确,验证请求的输出应该会立即返回
verificationState
(VERIFICATION_STATE_VERIFIED
)。如果verificationState
返回不同的值,则可能是因为您在发出请求时未使用正确的 OAuth 令牌,或者代理无法与商家资料营业地点匹配。使用相同的 OAuth 令牌,针对商家资料中的商家拥有的所有营业地点请求营业地点验证。
与代理验证一样,如果您操作正确,验证请求的输出应该会立即返回
verificationState
(VERIFICATION_STATE_VERIFIED
)。如果verificationState
返回不同的值,则可能是因为您在发出请求时未使用正确的 OAuth 令牌,或者商家资料营业地点对应的并非一个已申领该商家资料且通过验证的商家。使用入口点
LOCATION
发布代理。发布您想让用户通过 Google 搜索和 Google 地图找到的特定营业地点,为这些营业地点启用消息功能。发布流程开始后,在几小时内,每个已发布的营业地点便可向用户提供消息功能。
完成上述步骤后,所有消费者消息都将发布到您注册的 Business Messages webhook,您必须通过 Business Messages API 向消费者发送回复。