如何通过Google APIs获取已认证Google用户的组织名称

我之前也碰到过一模一样的情况——明明在Google Apps Admin面板里给用户配置好了组织信息，调用Directory API拿到用户对象后，organizations字段却始终是null。结合我的踩坑经验，给你梳理几个核心原因和解决办法：

1. 显式指定API请求的Projection参数 #

Directory API的users.get接口默认用的是basic投影模式，这种模式只返回用户的核心基础信息（比如姓名、邮箱），不会包含组织、地址这类扩展字段。你必须手动指定projection为full，才能拉取完整的用户信息，包括组织数据。

修改你的代码，加上setProjection("full")即可：

User user = directory.users().get(id)
    .setProjection("full")
    .execute();

2. 确认权限范围与服务账号授权 #

你用的服务账号必须满足两个关键条件：

• 已经开启域范围委派权限，并且在Google Admin控制台的API权限设置里，添加了至少https://www.googleapis.com/auth/admin.directory.user.readonly这个权限范围（如果需要修改用户信息就用admin.directory.user）
• 拥有模拟你代码中connection.getDomainAdminEmail对应域管理员账号的权限

如果权限不足，API会返回成功的用户对象，但会自动过滤掉扩展字段，就会出现organizations为null的情况。

3. 验证用户是否属于你的域 #

只有域内用户的组织信息才会被Directory API返回，如果用户是用个人Gmail账号（而非你的Google Workspace域邮箱）登录的，那即使Admin面板里没有关联该用户，organizations字段也会是null。先确认下该用户的邮箱是否属于你的域。

4. 再次核对Admin面板的组织配置 #

最后再检查一遍：在Admin控制台的用户详情页，「组织」标签下是否确实填写了公司名称、部门等信息，并且已经保存生效。虽然这种配置不同步的情况很少见，但也可以排除下。

按照上面的步骤排查后，应该就能正常获取到用户的组织信息了，user.getOrganizations()会返回包含公司名称等数据的列表。

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