使用Google Workspace REST API列组成员时遇404域名未找到错误求助

遇到Domain not found错误，大概率是遗漏了以下关键操作，按顺序排查修复：

1. 启用Admin Directory API #

在Google Cloud Console的对应项目中，搜索并启用Admin SDK Directory API。API未启用时，即使权限配置正确也会返回404类错误。

2. 完成完整的域范围委派配置 #

仅添加权限范围不够，需在Google Workspace Admin控制台完成授权：

• 登录Google Workspace Admin后台，进入「安全」>「API控制」>「域范围委派」
• 点击「添加新的客户端ID」，输入服务账号的客户端ID（可在Cloud Console服务账号详情页获取）
• 在「OAuth权限范围」中填入https://www.googleapis.com/auth/admin.directory.group.readonly，点击「授权」
• 确认权限范围拼写正确，且状态为已授权

3. 验证userKey有效性 #

curl命令中的userKey必须是你的Google Workspace域内的有效用户邮箱，建议使用域超级管理员账号（避免权限不足）。若邮箱错误或用户不属于当前域，会触发Domain not found错误。

4. 确保令牌生成时指定模拟用户 #

生成OAuth2令牌时，必须明确指定要模拟的域内用户（即userKey对应的邮箱）：

• 用gcloud生成令牌需加--impersonate-service-account参数
• 手动生成JWT时，需将sub字段设置为该用户邮箱

补充测试建议 #

完成以上步骤后，可简化命令测试：

curl -v -H "Authorization: Bearer $TOKEN" https://admin.googleapis.com/admin/directory/v1/groups?domain=my-domain.com

将my-domain.com替换为你的实际Google Workspace域名，验证是否能返回结果。

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