Google My Business service account获取已验证位置问题排查
问题前置情况
- 企业持有多家已完成验证的Google My Business经营场所,可通过企业公司邮箱登录business.google.com查看所有位置
- 核心需求为后端自动拉取所有位置的全量用户评论,同步展示在公司官网;此前调用Google Place API时,接口仅返回最多5条最新评论,因此计划通过无终端交互的服务账号模式,调用Google My Business API获取完整评论数据
- 已完成的前置操作:使用公司邮箱在开发者控制台创建服务账号,通过Postman携带签名JWT成功获取有效access token;但调用账号列表接口
mybusinessaccountmanagement.googleapis.com/v1/accounts时,返回结果仅包含服务账号本身;使用占位符参数调用位置列表接口mybusiness.googleapis.com/v4/accounts/{ACCOUNT_ID}/locations时,仅返回空对象响应。
问题根因
- 服务账号是独立的Google身份实体,和创建它的公司邮箱账号、以及公司邮箱下关联的GMB资源没有自动权限继承关系,必须手动在GMB后台给服务账号授予资源访问权限,它才能拉取对应位置的数据
- 调用位置接口时填入的是占位符账号ID,并非企业真实的GMB账号ID,自然无法匹配到有效位置资源
解决操作步骤
- 使用持有GMB管理权限的企业主账号登录business.google.com,进入对应企业的管理后台,在权限设置板块,将服务账号对应的专属邮箱地址(格式通常为
[服务账号名称]@[项目ID].iam.gserviceaccount.com)添加为协作者,授予「查看位置、查看评论」的最小必要权限即可 - 为服务账号申请access token时,确保请求的OAuth scope包含
https://www.googleapis.com/auth/business.manage,缺失该scope会导致即使完成协作者授权,也无法正常拉取GMB相关数据 - 重新调用账号列表接口,获取接口返回中属于企业的真实GMB账号ID,将该ID替换掉位置接口中的占位符参数,再次调用位置列表接口即可返回所有关联的已验证经营场所信息,后续可基于位置ID调用评论接口拉取无条数限制的全量用户评论
方案可行性说明
- 该纯后端通过服务账号拉取评论的模式完全可行,不需要终端用户在官网浏览过程中做任何授权交互,是Google官方明确支持的GMB API使用场景
- 这种方式获取的评论不受Place API“最多返回5条最新评论”的限制,可同步位置下所有公开的用户评论
内容的提问来源于stack exchange,提问作者user1828473
相关产品推荐
相关产品推荐

