Lưu ý quan trọng: Chúng tôi không còn chấp nhận các lượt đăng ký mới cho Play EMM API.
Tìm hiểu thêm.
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 mới do EMM quản lý.
Tài nguyên Người dùng
được chuyển vào phần nội dung của yêu cầu phải bao gồm
accountIdentifier và accountType.
Nếu đã tồn tại một người dùng tương ứng có cùng mã nhận dạng tài khoản,
người dùng sẽ được cập nhật tài nguyên. Trong trường hợp này, chỉ
Bạn có thể thay đổi trường displayName.
Yêu cầu
Yêu cầu HTTP
POST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users
Tham số
| Tên thông số |
Giá trị |
Mô tả |
| Tham số đường dẫn |
enterpriseId |
string |
Mã doanh nghiệp.
|
Ủy quyền
Yêu cầu này cần được cho phép có phạm vi sau:
| Phạm vi |
|---|
https://www.googleapis.com/auth/androidenterprise |
Để biết thêm thông tin, hãy xem trang xác thực và uỷ quyền.
Nội dung yêu cầu
Trong nội dung yêu cầu, hãy cung cấp Tài nguyên người dùng với các thuộc tính sau:
| Tên tài sản |
Giá trị |
Mô tả |
Ghi chú |
| Thuộc tính bắt buộc |
accountIdentifier |
string |
Giá trị nhận dạng duy nhất mà bạn tạo cho người dùng này, chẳng hạn như "user342" hoặc "thành phần số 44418". Đừng sử dụng thông tin nhận dạng cá nhân (PII) cho tài sản này. Phải luôn đặt cho người dùng do EMM quản lý. Không được đặt cho người dùng do Google quản lý. |
|
accountType |
string |
Loại tài khoản mà người dùng này đại diện. Bạn có thể cài đặt userAccount trên nhiều thiết bị, nhưng deviceAccount chỉ dành cho một thiết bị riêng lẻ. Người dùng do Google quản lý (emmManaged) có thể thuộc một trong hai loại (userAccount, deviceAccount) nhưng người dùng do Google quản lý (googleManaged) luôn là userAccount.
Các giá trị được chấp nhận là:
- "
deviceAccount"
- "
userAccount"
|
|
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-26 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-26 UTC."],[[["\u003cp\u003eCreates or updates an EMM-managed user within a specified enterprise.\u003c/p\u003e\n"],["\u003cp\u003eRequires an \u003ccode\u003eaccountIdentifier\u003c/code\u003e and \u003ccode\u003eaccountType\u003c/code\u003e to define the user.\u003c/p\u003e\n"],["\u003cp\u003eUses a POST request to the \u003ccode\u003e/enterprises/enterpriseId/users\u003c/code\u003e endpoint.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003edisplayName\u003c/code\u003e is the only field that can be updated for existing users.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidenterprise\u003c/code\u003e scope is necessary.\u003c/p\u003e\n"]]],[],null,["# Users: insert\n\n| **Note:** Requires [authorization](#auth).\n\nCreates a new EMM-managed user.\n\n\u003cbr /\u003e\n\n\nThe [Users](/android/work/play/emm-api/v1/users) resource\npassed in the body of the request should include an\n`accountIdentifier` and an `accountType`.\n\nIf a corresponding user already exists with the same account identifier,\nthe user will be updated with the resource. In this case only the\n`displayName` field can be changed.\n\n\u003cbr /\u003e\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|----------|---------------------------|\n| **Path parameters** |||\n| `enterpriseId` | `string` | The ID of the enterprise. |\n\n### Authorization\n\nThis request requires authorization with the following scope:\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/androidenterprise` |\n\nFor more information, see the [authentication and authorization](/android/work/play/emm-api/v1/how-tos/authorizing) page.\n\n### Request body\n\nIn the request body, supply a [Users resource](/android/work/play/emm-api/v1/users#resource) with the following properties:\n\n| Property name | Value | Description | Notes |\n|---------------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| **Required Properties** ||||\n| `accountIdentifier` | `string` | A unique identifier you create for this user, such as \"user342\" or \"asset#44418\". Do not use personally identifiable information (PII) for this property. Must always be set for EMM-managed users. Not set for Google-managed users. | |\n| `accountType` | `string` | The type of account that this user represents. A `userAccount` can be installed on multiple devices, but a `deviceAccount` is specific to a single device. An EMM-managed user (`emmManaged`) can be either type (`userAccount`, `deviceAccount`), but a Google-managed user (`googleManaged`) is always a `userAccount`. \u003cbr /\u003e Acceptable values are: - \"`deviceAccount`\" - \"`userAccount`\" | |\n\nResponse\n--------\n\nIf successful, this method returns a [Users resource](/android/work/play/emm-api/v1/users#resource) in the response body."]]
