在商家资料中添加营业地点的初始配置

商家资料是一款简单易用的免费工具,可供商家和组织在各种 Google 产品和服务(包括 Google 搜索和 Google 地图)中管理自己的在线品牌形象。

Google My Business API 提供了一个用于在 Google 上管理营业地点信息的接口。商家可以通过 OAuth 同意页面来授权其他商家代表其管理商家资料。

商家资料中的受管理商家已通过商家资料验证流程完成验证。您可以扩展商家资料 OAuth 同意流程,指引这些商家开始使用 Business Messages,并在 Business Messages 上自动对其进行验证以便启动该功能。

这是一种更具推广性且更快的 Business Messages 启动方法,也是一种为商家资料营业地点启用消息功能的推荐流程。

前提条件

您必须是有权访问 Google My Business API 的现有商家资料合作伙伴。如果您不是,请按照商家资料前提条件申请访问权限。

获得 Google My Business API 的访问权限后,请按照其基本设置OAuth 设置指南操作,然后再继续。

为已通过验证的商家资料营业地点启用 Business Messages

  1. 在商家资料帐号所有者授权您代表其调用 Google My Business API 的现有 OAuth 同意流程中,更新该 API 的范围以包含

    • https://www.googleapis.com/auth/business.manage
    • https://www.googleapis.com/auth/businesscommunications

    必须同时具备这两个范围才能成功地自动对代理和营业地点进行验证。

  2. 创建一个代理,使其 displayName 与您在上一步中所获 OAuth 凭据拥有的至少一个“Google 我的商家”信息的名称相匹配。使用 Google My Business API 查询营业地点,以查找商家名称。

    在名称匹配方面,请注意:

    • 字符不区分大小写。
    • 代理名称中的每个字词都需要与 GMB 营业地点中的某个字词相匹配。例如,代理名称“GMB Bakery”与“Gmb Bakerry Mountain View”“Gmb Bakery”和“gmb bakery sunnyvale”相匹配,但与“Bakery San Francisco”不匹配。
  3. 对于商家资料中的每个营业地点,使用相同的 placeId 创建营业地点。从 Google My Business API 检索营业地点时,商家资料营业地点的 placeId 包含在 LocationKey 对象中。

  4. 使用您创建的代理和所获取的 OAuth 令牌,请求代理验证

    验证请求需要提供品牌联系信息,但如果代理名称与商家资料名称相符,并且您获得的 OAuth 令牌具有正确的范围,那么验证流程不会向品牌发送电子邮件。

    如果您操作正确,验证请求的输出应该会立即返回 verificationState (VERIFICATION_STATE_VERIFIED)。如果 verificationState 返回不同的值,则可能是因为您在发出请求时未使用正确的 OAuth 令牌,或者代理无法与商家资料营业地点匹配。

  5. 使用相同的 OAuth 令牌,针对商家资料中的商家拥有的所有营业地点请求营业地点验证

    与代理验证一样,如果您操作正确,验证请求的输出应该会立即返回 verificationState (VERIFICATION_STATE_VERIFIED)。如果 verificationState 返回不同的值,则可能是因为您在发出请求时未使用正确的 OAuth 令牌,或者商家资料营业地点对应的并非一个已申领该商家资料且通过验证的商家。

  6. 使用入口点 LOCATION 发布代理

  7. 发布您想让用户通过 Google 搜索和 Google 地图找到的特定营业地点,为这些营业地点启用消息功能。发布流程开始后,在几小时内,每个已发布的营业地点便可向用户提供消息功能。

完成上述步骤后,所有消费者消息都将发布到您注册的 Business Messages webhook,您必须通过 Business Messages API 向消费者发送回复。