Google My Business API locations列表请求未返回全部关联地点问题排查求助

我之前也碰到过类似的API返回不全的问题，结合官方文档和实际踩坑经验，给你几个可以深入排查的方向：

• 检查请求参数的隐性过滤
  很多时候是参数设置的细节问题：

  • 确认你有没有给请求加了filter参数，比如不小心加了verificationStatus=VERIFIED，会直接过滤掉未验证的地点；可以先去掉所有filter参数发起请求，看看是否能返回那些缺失的地点。
  • 注意pageSize和分页逻辑，默认的pageSize可能只有10个，很多地点会在后续分页里，记得设置pageSize=100（API允许的最大值），并且处理返回的nextPageToken来遍历所有结果，别漏了分页数据。
  • 再核对一遍请求的accountId是否正确，有些情况下，地点可能属于该账户的子商户组，你需要确保用的是顶层主账户的ID来发起请求。

• 核对地点的特殊状态
  API对不同状态的地点返回逻辑不一样：

  • 检查漏返回的地点是不是处于**暂停服务（SUSPENDED）**状态，这类地点默认不会出现在返回结果里，需要显式在filter中加入status=SUSPENDED才能获取到。
  • 如果是连锁品牌的门店，确认是否需要通过品牌账号的维度来调用API，有些连锁门店的关联关系需要特定的参数才能拉取全量数据。
  • 查看地点的locationState，如果地点处于草稿状态（比如必填信息没填完），API也不会主动返回这类未完成创建的地点。

• 权限的深层验证
  权限问题有时候不是表面看起来的那样：

  • 确认发起请求的OAuth令牌对应的账号，是否真的拥有目标地点的管理级权限（比如OWNER或MANAGER），有些SITE_CONTACT级别的权限可能会限制API的访问范围。可以调用accounts.permissions.list来查看该账号对目标地点的具体权限详情。
  • 排查是否存在多账号关联的情况，同一个地点可能被绑定到多个Google账号，你当前使用的账号虽然有权限，但API可能只返回该账号默认关联组下的地点，需要确认是否切换到了正确的关联账号。

• 用官方工具排除代码问题

  • 直接用官方的API Explorer来发起请求，和你自己代码的请求参数、返回结果做对比，排除代码中可能存在的请求构造错误（比如参数拼写错误、头部信息缺失等）。
  • 确认你使用的是最新的API v4版本，旧版本的返回逻辑可能存在差异，导致部分地点无法返回。

• 检查GMB后台的特殊设置

  • 登录GMB后台，看看漏返回的地点是否开启了位置隐藏设置，后台隐藏的地点API也会同步不返回。
  • 查看地点的历史记录，是否有过合并或迁移操作，如果原地点被合并到其他地点下，旧的地点ID就会失效，需要确认你要找的地点是否已经变更了ID。

内容的提问来源于stack exchange，提问作者kingkyle