通过Admin SDK创建二级域名用户别名报Invalid Input: alias_email错误

操作场景复现 #

• 目标操作：通过Admin SDK Directory API为指定用户创建关联二级域名的邮件别名
• 调用接口：发送POST请求至https://www.googleapis.com/admin/directory/v1/users/{{userid}}/aliases/
• 请求体参数：

{
    "alias":"person@gsuite.company.com"
}

• 实际返回结果：接口抛出400类校验错误，返回内容为：

{
    "error": {
        "code": 400,
        "message": "Invalid Input: alias_email",
        "errors": [
            {
                "message": "Invalid Input: alias_email",
                "domain": "global",
                "reason": "invalid"
            }
        ]
    }
}

• 前置核对动作：已对照Google官方用户别名配置指引完成参数格式核对，问题仍未解决

核心排查方向与解决方式 #

• 检查二级域名的租户关联状态
  只有在Google Workspace管理后台完成域名所有权验证、并正式加入租户域名列表的域名，才能被用于创建用户别名；仅完成DNS解析、未在租户侧完成验证绑定的二级域名，会被接口判定为无效输入。
• 校验别名字段的格式合规性
  • 别名邮箱的前缀部分不能包含非法特殊字符，长度、格式需匹配Google Workspace邮箱命名规则
  • 别名填写的域名部分需与租户内已验证域名完全一致，不能存在前后空格、拼写偏差
  • 目标别名不能与租户内已有正式用户、已有别名重名
• 核对调用权限配置
  接口调用使用的授权身份（服务账号/域管理员账号），需覆盖用户别名读写的权限范围，权限配置不全的场景下，部分异常会被泛化为输入类校验错误返回。
• 检查路径占位符替换正确性
  请求路径中的{{userid}}需替换为目标用户的有效唯一标识（用户ID或绑定的正式邮箱），不能保留未替换的占位符，部分接口版本会将路径参数异常的场景映射为别名字段校验错误。

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