重要提示:我们不再接受 Play EMM API 的新注册。
了解详情。
Users: update
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
更新由 EMM 管理的用户的详细信息。
只能与受 EMM 管理的用户(而非 Google 管理的用户)搭配使用。
在
用户
添加相应的资源仅 displayName
字段
可以更改其他字段必须取消设置或使用
当前有效值。
请求
HTTP 请求
PUT https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users/userId
参数
参数名称 |
值 |
说明 |
路径参数 |
enterpriseId |
string |
企业的 ID。
|
userId |
string |
用户的 ID。
|
授权
此请求需要获得以下范围的授权:
范围 |
https://www.googleapis.com/auth/androidenterprise |
如需了解详情,请参阅身份验证和授权页面。
请求正文
在请求正文中,提供具有以下属性的 Users 资源:
属性名称 |
值 |
说明 |
备注 |
可选属性 |
displayName |
string |
显示在界面中的名称。创建由 EMM 管理的用户时,是否设置此属性是可选操作。如果您设置了此属性,请使用一些笼统的名称(如“Example, Inc.”)或您的姓名(如 EMM)。不用于 Google 管理的用户账号。 |
可写入 |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-26。
[null,null,["最后更新时间 (UTC):2025-07-26。"],[[["\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."]]