GoogleLocations

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

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

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

图 1. 商家资料营业地点所有权的泳道图

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

  1. 从商家收集营业地点数据。

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

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

  3. 选择与您的营业地点匹配的营业地点。如果没有匹配项，请调用 accounts.locations.create，然后跳到第 5 步。

  4. 根据响应中 requestAdminRightsUrl 的状态，执行以下操作：

    1. 如果存在 requestAdminRightsUrl，则表明另一位用户拥有该商家信息的所有权。请将商家定向至该网址，以开始在商家资料中请求对现有营业地点的访问权限以及所有权。
    2. 如果 requestAdminRightsUrl 不存在，请调用 accounts.locations.create 并创建新的商家信息，我们稍后将会对这些商家信息进行验证。
  5. 如果您在这一过程中创建了新的商家信息，则可以利用验证 API 开始验证这些商家信息。有关详情，请参阅管理验证。