Method: users.update

Updates a user.

This 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.

For 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 for more information.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Identifies the user in the API request. The value can be the user's primary email address, alias email address, or unique user ID.

Request body

The request body contains an instance of User.

Response body

If successful, the response body contains an instance of User.

Authorization scopes

Requires the following OAuth scope:


For more information, see the Authorization guide.