Users: insert
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Erstellt einen neuen, von EMM verwalteten Nutzer.
Ressource Users
, die im Text der Anfrage übergeben werden, sollte ein
accountIdentifier und accountType.
Wenn bereits ein entsprechender Nutzer mit dieser Konto-ID vorhanden ist,
wird der Nutzer mit der Ressource aktualisiert. In diesem Fall ist nur das Tag
Das Feld „displayName“ kann geändert werden.
Anfrage
HTTP-Anfrage
POST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users
Parameter
| Parametername |
Wert |
Beschreibung |
| Pfadparameter |
enterpriseId |
string |
Die ID des Unternehmens.
|
Autorisierung
Für diese Anfrage ist eine Autorisierung mit folgendem Bereich erforderlich:
| Umfang |
|---|
https://www.googleapis.com/auth/androidenterprise |
Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.
Anfragetext
Geben Sie im Anfragetext eine Nutzerressource mit den folgenden Attributen an:
| Property-Name |
Wert |
Beschreibung |
Hinweise |
| Erforderliche Attribute |
accountIdentifier |
string |
Eine eindeutige Kennung, die Sie für diesen Nutzer erstellen, z. B. „user342“ oder "asset#44418". Verwenden Sie für diese Property keine personenidentifizierbaren Informationen. Muss für von EMM verwaltete Nutzer immer festgelegt werden. Nicht für von Google verwaltete Nutzer festgelegt. |
|
accountType |
string |
Der Kontotyp, den dieser Nutzer repräsentiert. Ein userAccount kann auf mehreren Geräten installiert werden, aber ein deviceAccount gilt speziell für ein einzelnes Gerät. Ein durch EMM verwalteter Nutzer (emmManaged) kann entweder vom Typ (userAccount, deviceAccount) sein, aber ein von Google verwalteter Nutzer (googleManaged) ist immer ein userAccount.
Zulässige Werte sind:
<ph type="x-smartling-placeholder"></ph>
- „
deviceAccount“
- „
userAccount“
|
|
Antwort
Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine Nutzerressource im Antworttext zurückgegeben.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 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."]]
