注意:API 即将进行重大更改,需要进行迁移工作。请时常关注我们即将发布的版本页面和弃用时间表,了解最新动态。您还可以注册加入我们的邮寄名单,以便接收最新动态。

GoogleLocations

借助 GoogleLocations API,您可以提前了解某个营业地点是否已在“Google 我的商家”中声明了所有权。这样,如果该营业地点已声明所有权,您可以立即请求访问该营业地点。此外,如果您管理批量验证的帐号,则可以提前更准确地选择可能的匹配项,并避免创建重复的营业地点。

该 API 端点会返回一个网址,用于指明某个营业地点是否已声明了所有权。如果已声明所有权,您可以使用同一网址启动访问权限请求流程。

下图简要介绍了获取营业地点所有权的过程。

图 1. “Google 我的商家”营业地点所有权的泳道图

您可以按照以下步骤使用 GoogleLocations API:

  1. 从商家收集营业地点数据。
  2. 调用 googleLocations.search 端点。在调用的正文中提供营业地点数据。或者,您可以通过查询字符串提供这一数据,类似于用户在 Google 搜索或 Google 地图中输入的内容。例如,“Starbucks 5th ave NYC”。

    该 API 会返回可能匹配的营业地点列表以及每个营业地点的相关信息,例如 locationName 和地址。

  3. 选择与您的营业地点匹配的营业地点。如果没有匹配项,请调用 accounts.locations.create,将 LocationKey.placeID 字段留空,然后跳到第 5 步。
  4. 根据响应中 requestAdminRightsUrl 的状态,执行以下操作:

    1. 如果存在 requestAdminRightsUrl,则表明另一位用户拥有该商家信息的所有权。请将商家定向至该网址,以开始在“Google 我的商家”中请求对现有营业地点的访问权限以及所有权。
    2. 如果 requestAdminRightsUrl 不存在,请调用 accounts.locations.create,并在 location 对象中提供第 3 步中返回的选定营业地点的 placeID
  5. 如果您在这一过程中创建了新的商家信息,则可以利用验证 API 开始验证这些商家信息。有关详情,请参阅管理验证