调用Google People API仅返回基础字段时获取目录用户信息的配置方法
问题描述
我开发了一款对接Google People API的聊天机器人,采用谷歌服务账户完成接口鉴权。机器人可接收携带消息发送者谷歌ID(示例值:1234567890987654321)的事件信息,希望通过服务账户查询获取消息发送者的姓名与邮箱地址。
目前已为服务账户配置域范围委托(domain-wide delegation),并授予https://www.googleapis.com/auth/directory.readonly权限,按照官方域范围权限规则,该权限本应支持目录用户信息查询操作,但实际接口响应仅返回Etag与ResourceName字段,未返回请求的names、emailAddresses字段。
请问需要调整哪些配置或调用逻辑,才能在使用服务账户发起People.Get接口调用时,获取域内任意目录用户的姓名与邮箱信息?
附当前可运行的测试调用代码(基于Go语言):
package main import ( "context" "log" "google.golang.org/api/option" "google.golang.org/api/people/v1" ) func main() { // 服务账户凭证文件路径 apiKeyFile := "credentials.json" // 目标目录用户的谷歌ID resourceName := "people/1234567890987654321" fields := "names,emailAddresses" ctx := context.Background() // 代码注释标注默认已包含directory.readonly权限 s, _ := people.NewService(ctx, option.WithCredentialsFile(apiKeyFile)) pCall := s.People.Get(resourceName) pCall.PersonFields(fields) person, _ := pCall.Do() log.Print(person.Etag) for _, address := range person.EmailAddresses { log.Print(address.Value) } for _, name := range person.Names { log.Print(name.DisplayName) } }
解决方案
出现该现象的核心原因是使用服务账户发起域内查询时,未模拟域内用户身份完成鉴权流程,并非权限配置本身的错误,需调整的操作点如下:
- 服务账户以自身默认身份鉴权调用
People.Get时,仅能查询自身关联的联系人信息,无法跨账户访问域内其他用户的资源。即使已配置域范围委托、授予对应目录只读权限,也必须在鉴权环节显式指定模拟的域内用户身份(可选择域内具备目录基础读权限的管理员账号),才能获得查询其他用户资源的合法权限。 - 调整Go代码中的服务账户初始化逻辑,不要仅传入凭证文件直接生成服务客户端,需要在JWT凭证配置中追加
subject参数,设置为待模拟的域内用户邮箱地址。调整后的核心逻辑示例:// 加载服务账户凭证生成JWT配置 cfg, err := google.JWTConfigFromJSON(credBytes, people.PeopleDirectoryReadonlyScope) if err != nil { log.Fatalf("凭证加载失败: %v", err) } // 配置模拟的域内用户身份,触发域范围委托的权限映射 cfg.Subject = "admin@your-workspace-domain.com" // 基于模拟身份的HTTP客户端生成People API服务实例 s, err := people.NewService(ctx, option.WithHTTPClient(cfg.Client(ctx))) - 完成两项配置校验:
- 确认服务账户的域范围委托列表中,已单独添加
people.directory.readonly权限。仅配置directory.readonly权限仅支持基础Directory API查询,不会返回People API对应的字段结构,无法触发People API的目录字段数据填充。 - 确认传入的
resourceName格式正确,目标用户属于服务账户委托的谷歌工作空间域内,不存在跨域调用场景。
- 确认服务账户的域范围委托列表中,已单独添加
- 调试技巧:临时在
PersonFields参数中追加metadata字段,通过返回的资源元数据确认当前鉴权身份对目标资源的访问权限范围,快速定位是否为身份模拟失效导致的字段返回为空。
内容的提问来源于stack exchange,提问作者Dave Neeley
相关产品推荐
相关产品推荐

