Ważne: nie przyjmujemy już nowych rejestracji w interfejsie Play EMM API.
Więcej informacji
Users: insert
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Tworzy nowego użytkownika zarządzanego przez EMM.
Zasób Users
przekazywane w treści żądania powinny zawierać
accountIdentifier i accountType.
Jeśli istnieje już odpowiedni użytkownik z tym samym identyfikatorem konta,
zasób zostanie zaktualizowany do użytkownika. W tym przypadku tylko
Pole displayName można zmienić.
Żądanie
Żądanie HTTP
POST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users
Parametry
| Nazwa parametru |
Wartość |
Opis |
| Parametry ścieżki |
enterpriseId |
string |
Identyfikator grupy.
|
Autoryzacja
To żądanie wymaga autoryzacji w tym zakresie:
| Zakres |
|---|
https://www.googleapis.com/auth/androidenterprise |
Więcej informacji znajdziesz na stronie dotyczącej uwierzytelniania i autoryzacji.
Treść żądania
W treści żądania podaj zasób Użytkownicy z tymi właściwościami:
| Nazwa usługi |
Wartość |
Opis |
Uwagi |
| Właściwości wymagane |
accountIdentifier |
string |
Unikalny identyfikator utworzony dla danego użytkownika, np. „użytkownik342” lub „asset#44418”. Nie używaj w tej usłudze informacji umożliwiających identyfikację osób. Ta wartość musi być zawsze ustawiona dla użytkowników zarządzanych przez EMM. Ustawienie nie jest ustawione dla użytkowników zarządzanych przez Google. |
|
accountType |
string |
Rodzaj konta, które reprezentuje ten użytkownik. Element userAccount może być zainstalowany na wielu urządzeniach, ale deviceAccount dotyczy tylko jednego. Użytkownik zarządzany przez EMM (emmManaged) może być dowolnym typem (userAccount, deviceAccount), ale użytkownik zarządzany przez Google (googleManaged) to zawsze userAccount.
Akceptowane wartości to:
- „
deviceAccount”
- „
userAccount”
|
|
Odpowiedź
Jeśli operacja się uda, metoda zwróci zasób Użytkownicy w treści odpowiedzi.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-26 UTC.
[null,null,["Ostatnia aktualizacja: 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."]]
