Google People API connections.list返回403权限不足问题求助

这种权限不足的问题在Google OAuth集成里挺常见的，尤其是当你觉得已经配置对权限但还是报错的时候，我帮你梳理几个关键排查点：

• 先确认权限范围的准确性
  People API的联系人列表接口需要的权限是https://www.googleapis.com/auth/contacts（读写）或者https://www.googleapis.com/auth/contacts.readonly（只读），你要确保初始化时的scope完全和这个一致——别打错字，别漏了readonly（如果是只读需求），也别加多余的路径或者参数。

• 检查权限是否真的被传递到授权流程
  有时候代码里的scope配置可能没生效，比如是不是把scope写在了错误的位置？正确的初始化应该是在gapi.auth2.init的参数里指定scope：

  gapi.auth2.init({
    client_id: '你的客户端ID',
    scope: 'https://www.googleapis.com/auth/contacts.readonly'
  });
  

  别把scope放在signIn的参数里却没在init里声明，或者反过来，确保整个流程里的scope是统一的。

• 强制用户重新授权，清除旧权限缓存
  这是最容易踩的坑：用户之前可能已经授权过你的应用，但当时的权限范围比现在小，浏览器会缓存旧的授权状态。哪怕你后来改了scope，默认情况下OAuth不会重新请求权限。解决方法是在调用signIn时加上prompt: 'consent'参数，强制弹出授权窗口让用户重新确认权限：

  gapi.auth2.getAuthInstance().signIn({
    prompt: 'consent'
  });
  

  这个操作会覆盖之前的授权缓存，确保新的权限被授予。

• 验证当前实际获得的权限
  你可以在代码里加一行调试，打印当前用户被授予的权限，看看是不是和你需要的匹配：

  const grantedScopes = gapi.auth2.getAuthInstance().currentUser.get().getGrantedScopes();
  console.log('当前授权的权限:', grantedScopes);
  

  如果输出里没有你需要的People API权限，那说明授权流程确实没拿到权限，得回头检查scope配置和授权触发逻辑。

• 检查Google Cloud Console的配置
  虽然你在API Explorer里能用，但要确保你的项目里：

  1. People API已经在API库中启用；
  2. OAuth同意屏幕里已经添加了对应的权限范围；
  3. 如果是测试状态，当前登录的用户已经被添加为测试用户（否则非测试用户无法授权）。

我之前遇到过类似的问题，就是因为旧的授权缓存没清，加上prompt: 'consent'之后就解决了。你可以先试试这个方法，再结合上面的排查点一步步验证。

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