Users: insert
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Membuat pengguna terkelola EMM baru.
Resource Users
yang diteruskan di isi permintaan harus mencakup
accountIdentifier dan accountType.
Jika sudah ada pengguna yang memiliki ID akun yang sama,
pengguna akan diperbarui
dengan sumber daya tersebut. Dalam kasus ini, hanya
Kolom displayName dapat diubah.
Permintaan
Permintaan HTTP
POST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users
Parameter
| Nama parameter |
Nilai |
Deskripsi |
| Parameter jalur |
enterpriseId |
string |
ID perusahaan.
|
Otorisasi
Permintaan ini memerlukan otorisasi dengan cakupan berikut:
| Cakupan |
|---|
https://www.googleapis.com/auth/androidenterprise |
Untuk mengetahui informasi selengkapnya, lihat halaman autentikasi dan otorisasi.
Isi permintaan
Dalam isi permintaan, berikan Users resource dengan properti berikut:
| Nama properti |
Nilai |
Deskripsi |
Catatan |
| Properti yang Diperlukan |
accountIdentifier |
string |
ID unik yang Anda buat untuk pengguna ini, seperti "user342" atau "aset#44418". Jangan gunakan informasi identitas pribadi (PII) untuk properti ini. Harus selalu ditetapkan untuk pengguna yang dikelola EMM. Tidak ditetapkan untuk pengguna yang dikelola Google. |
|
accountType |
string |
Jenis akun yang diwakili pengguna ini. userAccount dapat diinstal di beberapa perangkat, tetapi deviceAccount dikhususkan untuk satu perangkat. Pengguna yang dikelola EMM (emmManaged) dapat berupa salah satu jenis (userAccount, deviceAccount), tetapi pengguna yang dikelola Google (googleManaged) selalu userAccount.
Nilai yang dapat diterima:
- "
deviceAccount"
- "
userAccount"
|
|
Respons
Jika berhasil, metode ini akan menampilkan Users resource dalam isi respons.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-26 UTC.
[null,null,["Terakhir diperbarui pada 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."]]
