Method: users.update
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
更新用户。
此方法支持修补语义,这意味着您只需添加要更新的字段即可。系统会保留请求中不存在的字段,并清除设置为 null
的字段。
对于包含数组的重复字段,无法逐个修补数组中的各个项;必须在请求正文中为所有项提供所需的值。如需了解详情,请参阅用户账号指南。
HTTP 请求
PUT https://admin.googleapis.com/admin/directory/v1/users/{userKey}
网址采用 gRPC 转码语法。
路径参数
参数 |
userKey |
string
用于在 API 请求中标识用户。该值可以是用户的主电子邮件地址、别名电子邮件地址或唯一用户 ID。
|
响应正文
如果成功,则响应正文包含一个 User
实例。
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/admin.directory.user
如需了解详情,请参阅授权指南。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[],[],null,["# Method: users.update\n\nUpdates a user.\n\nThis method supports patch semantics, meaning that you only need to include the fields you wish to update. Fields that are not present in the request will be preserved, and fields set to `null` will be cleared.\n\nFor repeating fields that contain arrays, individual items in the array can't be patched piecemeal; they must be supplied in the request body with the desired values for all items. See the [user accounts guide](https://developers.google.com/workspace/admin/directory/v1/guides/manage-users#update_user) for more information.\n\n### HTTP request\n\n`PUT https://admin.googleapis.com/admin/directory/v1/users/{userKey}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------|---------------------------------------------------------------------------------------------------------------------------------------------|\n| `userKey` | `string` Identifies the user in the API request. The value can be the user's primary email address, alias email address, or unique user ID. |\n\n### Request body\n\nThe request body contains an instance of [User](/workspace/admin/directory/reference/rest/v1/users#User).\n\n### Response body\n\nIf successful, the response body contains an instance of [User](/workspace/admin/directory/reference/rest/v1/users#User).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/admin.directory.user`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]