Method: users.get

ユーザーを取得します。

HTTP リクエスト

GET https://admin.googleapis.com/admin/directory/v1/users/{userKey}

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
userKey

string

API リクエスト内のユーザーを識別します。値は、ユーザーのメインのメールアドレス、エイリアス メールアドレス、または一意のユーザー ID です。

クエリ パラメータ

パラメータ
customFieldMask

string

スキーマ名のカンマ区切りのリスト。これらのスキーマからすべてのフィールドが取得されます。projection=custom の場合にのみ設定する必要があります。

projection

enum (Projection)

このユーザーに対して取得するフィールドのサブセット。

viewType

enum (ViewType)

ユーザーの管理者限定ビューを取得するか、ドメイン全体の公開ビューを取得するかを指定します。詳細については、管理者以外のユーザーを取得するをご覧ください。

リクエスト本文

リクエストの本文は空にする必要があります。

レスポンスの本文

成功した場合、レスポンスの本文には User のインスタンスが含まれます。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/admin.directory.user
  • https://www.googleapis.com/auth/admin.directory.user.readonly

詳しくは、承認ガイドをご覧ください。

予測

列挙型
BASIC ユーザーのカスタム フィールドは含めないでください。
CUSTOM customFieldMask でリクエストされたスキーマのカスタム フィールドを含めます。
FULL このユーザーに関連付けられているすべてのフィールドを含めます。

ViewType

列挙型
admin_view 結果には、ユーザーの管理者専用フィールドとドメインで一般公開されるフィールドの両方が含まれます。
domain_public 結果には、ドメイン内の他のユーザーに一般公開されているユーザーのフィールドのみが含まれます。