Method: users.insert
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tạo người dùng.
Đôi khi, các lệnh gọi Mutate ngay sau khi tạo người dùng có thể không thành công vì người dùng chưa được tạo đầy đủ do độ trễ truyền tải trong phần phụ trợ của chúng tôi. Hãy kiểm tra thông tin chi tiết về lỗi "Quá trình tạo người dùng chưa hoàn tất" để xem liệu có phải là trường hợp này hay không. Trong trường hợp này, bạn có thể thử lại các lệnh gọi sau một khoảng thời gian.
Nếu resolveConflictAccount
được đặt thành true
, thì mã phản hồi 202
có nghĩa là có một tài khoản không được quản lý xung đột và đã được mời tham gia tổ chức. Mã phản hồi 409
có nghĩa là có một tài khoản xung đột nên người dùng không được tạo dựa trên tuỳ chọn xử lý tài khoản người dùng không được quản lý đã chọn.
Yêu cầu HTTP
POST https://admin.googleapis.com/admin/directory/v1/users
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số truy vấn
Thông số |
resolveConflictAccount |
boolean
Không bắt buộc. Nếu bạn đặt thành true , tuỳ chọn được chọn để xử lý tài khoản người dùng không được quản lý sẽ được áp dụng. Mặc định: false
|
Nội dung yêu cầu
Nội dung yêu cầu chứa một bản sao của User
.
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ chứa một thực thể User
mới tạo.
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/admin.directory.user
Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[],[],null,["# Method: users.insert\n\nCreates a user.\n\nMutate calls immediately following user creation might sometimes fail as the user isn't fully created due to propagation delay in our backends. Check the error details for the \"User creation is not complete\" message to see if this is the case. Retrying the calls after some time can help in this case.\n\nIf `resolveConflictAccount` is set to `true`, a `202` response code means that a conflicting unmanaged account exists and was invited to join the organization. A `409` response code means that a conflicting account exists so the user wasn't created based on the [handling unmanaged user accounts](https://support.google.com/a/answer/11112794) option selected.\n\n### HTTP request\n\n`POST https://admin.googleapis.com/admin/directory/v1/users`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|--------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `resolveConflictAccount` | `boolean` Optional. If set to `true`, the option selected for [handling unmanaged user accounts](https://support.google.com/a/answer/11112794) will apply. Default: `false` |\n\n### Request body\n\nThe request body contains an instance of [User](/workspace/admin/directory/reference/rest/v1/users#User).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [User](/workspace/admin/directory/reference/rest/v1/users#User).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/admin.directory.user`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]