Method: users.update
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Actualiza un usuario.
Este método admite la semántica de parches, lo que significa que solo debes incluir los campos que deseas actualizar. Se conservarán los campos que no estén presentes en la solicitud y se borrarán los campos configurados como null.
En el caso de los campos repetidos que contienen arrays, los elementos individuales del array no se pueden aplicar de forma parcial; deben proporcionarse en el cuerpo de la solicitud con los valores deseados para todos los elementos. Consulta la guía de cuentas de usuario para obtener más información.
Solicitud HTTP
PUT https://admin.googleapis.com/admin/directory/v1/users/{userKey}
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros |
userKey |
string
Identifica al usuario en la solicitud a la API. El valor puede ser la dirección de correo electrónico principal del usuario, la dirección de correo electrónico de alias o el ID de usuario único.
|
Cuerpo de la solicitud
El cuerpo de la solicitud contiene una instancia de User.
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de User.
Permisos de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/admin.directory.user
Para obtener más información, consulta la Guía de autorización.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 2025-07-25 (UTC)"],[],[],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)."]]
