Users: update
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Aktualisiert die Details eines von EMM verwalteten Nutzers.
Kann nur für Nutzer verwendet werden, die vom EMM-Anbieter verwaltet werden, nicht für Nutzer, die von Google verwaltet werden.
Übergeben Sie die neuen Details in der
Nutzer
Ressource im Anfragetext. Nur das Feld displayName
geändert werden kann. Andere Felder müssen entweder nicht festgelegt werden oder den Parameter
derzeit aktiver Wert.
Anfrage
HTTP-Anfrage
PUT https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users/userId
Parameter
| Parametername |
Wert |
Beschreibung |
| Pfadparameter |
enterpriseId |
string |
Die ID des Unternehmens.
|
userId |
string |
Die ID des Nutzers.
|
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 |
| Optionale Attribute |
displayName |
string |
Der Name, der auf Benutzeroberflächen angezeigt wird. Das Festlegen dieses Attributs ist beim Erstellen von EMM-verwalteten Nutzern optional. Wenn Sie diese Eigenschaft festlegen, verwenden Sie einen generischen Namen über die Organisation (z. B. „Beispiel GmbH“) oder Ihren Namen (als EMM-Anbieter). Wird nicht für von Google verwaltete Nutzerkonten verwendet. |
Bearbeitbar
|
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\u003eUpdates the \u003ccode\u003edisplayName\u003c/code\u003e of an EMM-managed user, requiring authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidenterprise\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eThe request must be a \u003ccode\u003ePUT\u003c/code\u003e request sent to \u003ccode\u003ehttps://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users/userId\u003c/code\u003e, replacing \u003ccode\u003eenterpriseId\u003c/code\u003e and \u003ccode\u003euserId\u003c/code\u003e with their respective values.\u003c/p\u003e\n"],["\u003cp\u003eOnly the \u003ccode\u003edisplayName\u003c/code\u003e field can be updated; all other fields must remain unchanged or unset.\u003c/p\u003e\n"],["\u003cp\u003eThis operation is exclusively for EMM-managed users and is not applicable to Google-managed users.\u003c/p\u003e\n"]]],[],null,["# Users: update\n\n| **Note:** Requires [authorization](#auth).\n\nUpdates the details of an EMM-managed user.\n\n\u003cbr /\u003e\n\n\nCan be used with EMM-managed users only (not Google managed users).\nPass the new details in the\n[Users](/android/work/play/emm-api/v1/users)\nresource in the request body. Only the `displayName` field\ncan be changed. Other fields must either be unset or have the\ncurrently active value.\n\nRequest\n-------\n\n### HTTP request\n\n```\nPUT https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users/userId\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|----------|---------------------------|\n| **Path parameters** |||\n| `enterpriseId` | `string` | The ID of the enterprise. |\n| `userId` | `string` | The ID of the user. |\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| **Optional Properties** ||||\n| `displayName` | `string` | The name that will appear in user interfaces. Setting this property is optional when creating EMM-managed users. If you do set this property, use something generic about the organization (such as \"Example, Inc.\") or your name (as EMM). Not used for Google-managed user accounts. | writable |\n\nResponse\n--------\n\nIf successful, this method returns a [Users resource](/android/work/play/emm-api/v1/users#resource) in the response body."]]
