Method: users.update
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
ユーザーを更新します。
このメソッドはパッチのセマンティクスをサポートしているため、更新するフィールドのみを含める必要があります。リクエストに存在しないフィールドは保持され、null
に設定されたフィールドはクリアされます。
配列を含む繰り返しフィールドの場合、配列内の個々のアイテムを個別にパッチすることはできません。すべてのアイテムに必要な値をリクエスト本文で指定する必要があります。詳しくは、ユーザー アカウント ガイドをご覧ください。
HTTP リクエスト
PUT https://admin.googleapis.com/admin/directory/v1/users/{userKey}
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ |
userKey |
string
API リクエストでユーザーを識別します。この値は、ユーザーのメインのメールアドレス、エイリアス メールアドレス、一意のユーザー ID のいずれかです。
|
リクエストの本文
リクエストの本文には User
のインスタンスが含まれます。
レスポンスの本文
成功した場合、レスポンスの本文には User
のインスタンスが含まれます。
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/admin.directory.user
詳しくは、認可ガイドをご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 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)."]]