Users: insert
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
EMM tarafından yönetilen yeni bir kullanıcı oluşturur.
Kullanıcılar kaynağı
isteğin gövdesinde iletilen bir
accountIdentifier
ve accountType
.
Aynı hesap tanımlayıcısına sahip karşılık gelen bir kullanıcı zaten varsa
kullanıcı kaynakla güncellenecektir. Bu durumda yalnızca
displayName
alanı değiştirilebilir.
İstek
HTTP isteği
POST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users
Parametreler
Parametre adı |
Değer |
Açıklama |
Yol parametreleri |
enterpriseId |
string |
Kuruluşun kimliği.
|
Yetkilendirme
Bu istek, aşağıdaki kapsamla yetkilendirme gerektiriyor:
Kapsam |
https://www.googleapis.com/auth/androidenterprise |
Daha fazla bilgi edinmek için kimlik doğrulama ve yetkilendirme sayfasına göz atın.
İstek içeriği
İstek gövdesinde, aşağıdaki özelliklere sahip bir Kullanıcılar kaynağı sağlayın:
Mülk adı |
Değer |
Açıklama |
Notlar |
Zorunlu Özellikler |
accountIdentifier |
string |
Bu kullanıcı için oluşturduğunuz benzersiz bir tanımlayıcı (ör. "kullanıcı342") veya "asset#44418" öğesini kullanın. Bu mülk için kimliği tanımlayabilecek bilgiler (PII) kullanmayın. EMM tarafından yönetilen kullanıcılar için her zaman ayarlanmalıdır. Google tarafından yönetilen kullanıcılar için ayarlanmaz. |
|
accountType |
string |
Bu kullanıcının temsil ettiği hesap türüdür. userAccount birden fazla cihaza yüklenebilir ancak deviceAccount tek bir cihaza özgüdür. EMM tarafından yönetilen bir kullanıcı (emmManaged ) iki türden (userAccount , deviceAccount ) olabilir, ancak Google tarafından yönetilen bir kullanıcı (googleManaged ) her zaman bir userAccount 'dir.
Kabul edilen değerler şunlardır:
- "
deviceAccount "
- "
userAccount "
|
|
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-26 UTC.
[null,null,["Son güncelleme tarihi: 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."]]