Method: users.insert

创建用户。

在创建用户后立即进行的 mutate 调用有时可能会失败，因为我们的后端存在传播延迟，导致用户未完全创建。请查看“用户创建未完成”消息的错误详情，看看是否属于这种情况。在这种情况下，过一段时间再重试调用可能会有帮助。

如果 resolveConflictAccount 设置为 true，则为查找并添加非受管用户选择的选项将用于解决有冲突的账号：

  • 200 响应代码表示已创建用户（或替换了现有的非受管个人账号）。
  • 202 响应代码表示存在冲突的非受管个人账号，并且该账号已受邀加入组织。
  • 409 响应代码表示存在冲突的账号，因此未创建用户（例如，根据所选的保留账号的选项，或者电子邮件地址与非受管工作账号或现有受管用户冲突）。

如需详细了解如何解决重复账号错误，请参阅解决重复账号错误和转移非受管工作账号。

HTTP 请求

POST https://admin.googleapis.com/admin/directory/v1/users

网址采用 gRPC 转码语法。

查询参数

参数
resolveConflictAccount

boolean

可选。如果设置为 true，则应用为查找并添加非受管用户选择的选项来解决账号冲突问题。默认：false

请求正文

请求正文包含一个 User 实例。

响应正文

如果成功，响应正文将包含一个新创建的 User 实例。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/admin.directory.user

如需了解详情，请参阅授权指南。