Method: users.update
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Met à jour un utilisateur.
Cette méthode est compatible avec la sémantique "patch", ce qui signifie que vous n'avez besoin d'inclure que les champs que vous souhaitez mettre à jour. Les champs qui ne sont pas présents dans la requête seront conservés, et les champs définis sur null seront effacés.
Pour les champs répétés contenant des tableaux, les éléments individuels du tableau ne peuvent pas être corrigés individuellement. Ils doivent être fournis dans le corps de la requête avec les valeurs souhaitées pour tous les éléments. Pour en savoir plus, consultez le guide des comptes utilisateur.
Requête HTTP
PUT https://admin.googleapis.com/admin/directory/v1/users/{userKey}
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres |
userKey |
string
Identifie l'utilisateur dans la requête API. La valeur peut être l'adresse e-mail principale, l'adresse e-mail d'alias ou l'ID utilisateur unique de l'utilisateur.
|
Corps de la requête
Le corps de la requête contient une instance de User.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une instance de User.
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/admin.directory.user
Pour en savoir plus, consultez le guide d'autorisation.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 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)."]]
