使用Google OAuth 2.0 Playground调用Admin SDK接口遇400/404错误求助

• 核心限制：Admin SDK仅面向Google Workspace管理员账号
  你使用的个人@gmail.com账号不属于Google Workspace（原G Suite）域，而Admin SDK的目录类接口（包括directory_v1的用户读取接口），是专门为Workspace域管理员设计的工具。个人账号哪怕成功授权admin.directory.user.readonly权限，也没有访问域内用户数据的资格。

• 400错误的原因
  调用https://admin.googleapis.com/admin/directory/v1/users接口时，API需要明确你要读取哪个Workspace域的用户列表，但个人账号未绑定任何受管理的域，API无法识别请求目标，因此返回400错误。

• 404错误的原因
  你从userinfo接口获取的是个人账号的ID，但Admin SDK的/users/{userKey}接口仅用于读取Workspace域内的用户。你的个人账号不在任何受管理的Workspace域中，API找不到对应资源，所以返回404。

• 换凭证无效的原因
  不管是默认还是自定义OAuth凭证，只要登录的是个人Gmail账号，就不满足Admin SDK的使用前提——必须是Workspace管理员账号，且已在Workspace后台启用Admin SDK API。

解决办法 #

如果要测试Admin SDK的用户接口，你需要：

1. 拥有一个Google Workspace管理员账号（非普通个人Gmail账号）
2. 登录Workspace管理控制台，启用Admin SDK API
3. 使用该管理员账号登录OAuth 2.0 Playground，授权对应权限后再调用接口

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