Method: users.update
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Atualiza um usuário.
Esse método oferece suporte à semântica de patch, o que significa que você só precisa incluir os campos que quer atualizar. Os campos que não estiverem presentes na solicitação serão preservados, e os campos definidos como null serão apagados.
Para campos repetidos que contêm matrizes, os itens individuais na matriz não podem ser corrigidos parcialmente. Eles precisam ser fornecidos no corpo da solicitação com os valores desejados para todos os itens. Consulte o guia de contas de usuário para mais informações.
Solicitação HTTP
PUT https://admin.googleapis.com/admin/directory/v1/users/{userKey}
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
| Parâmetros |
userKey |
string
Identifica o usuário na solicitação da API. O valor pode ser o endereço de e-mail principal, o endereço de e-mail de alias ou o ID exclusivo do usuário.
|
Corpo da solicitação
O corpo da solicitação contém uma instância de User.
Corpo da resposta
Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de User.
Escopos de autorização
Requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/admin.directory.user
Para mais informações, consulte o guia de autorização.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 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)."]]
