G Suite API添加用户至非主域名：修改邮箱后缀仍无效

我来帮你排查下这个问题，这种情况我之前也碰到过几次，改了邮箱后缀却不生效，大概率是这几个环节出了问题：

• 先确认子域名的G Suite配置
  首先得检查你的sub.domain.com是不是已经在G Suite管理控制台完成了域名验证，并且开启了"允许创建用户"的权限。主域名默认是启用的，但新添加的子域名经常会被忽略这一步——你可以登录G Suite admin后台，进入「域名」页面，找到sub.domain.com，看看它的状态是不是"已验证"，并且在用户设置里允许用这个域名创建账号。

• 检查代码中是否遗漏了domain参数设置
  有些G Suite Admin SDK的用户创建接口，除了设置primaryEmail，还需要单独指定domain字段。比如在PHP的客户端库中，你可能只改了邮箱后缀，但没有显式设置域名：

  // 除了设置primaryEmail，还要添加这一行
  $userInstance->setDomain('sub.domain.com');
  

  这一步很关键，因为有时候SDK会默认读取主域名作为domain参数，哪怕你邮箱后缀是子域名，也会被覆盖。

• 排查是否有代码逻辑覆盖了邮箱后缀
  你可以在设置$suggestedEmail之后，加个调试输出看看最终的邮箱地址是不是正确的：

  var_dump($suggestedEmail); // 确认输出是xxx@sub.domain.com
  

  有时候项目里会有统一的配置文件或者工具函数，在你设置完邮箱后，又把后缀替换成了主域名，比如从配置里读取DEFAULT_DOMAIN常量之类的，这时候就得找到这些逻辑并调整。

• 验证API权限和范围
  确保你的服务账号或者OAuth令牌拥有操作子域名用户的权限，必须包含https://www.googleapis.com/auth/admin.directory.user这个API范围，而且授权的管理员账号要有子域名的用户管理权限。如果权限不够，G Suite会默认用主域名创建用户，甚至直接返回错误。

• 用API测试工具直接验证
  你可以用G Suite Admin SDK的官方测试工具手动创建一个xxx@sub.domain.com的用户，如果API直接调用能成功，那问题肯定在你的代码逻辑里；如果API调用也失败，那就是G Suite控制台的配置问题，比如域名没启用用户创建，或者权限不足。

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