Method: users.list

削除されたユーザーまたはドメイン内のすべてのユーザーのページネーション付きリストを取得します。

HTTP リクエスト

GET https://admin.googleapis.com/admin/directory/v1/users

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

クエリ パラメータ

パラメータ
customFieldMask

string

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

string

お客様の Google Workspace アカウントの一意の ID。複数ドメイン アカウントの場合、お客様のすべてのユーザーを取得するには、domain ではなくこのフィールドを使用します。my_customer エイリアスを使用してアカウントの customerId を表すこともできます。customerId は、Users リソースの一部として返されます。customer パラメータまたは domain パラメータのいずれかを指定する必要があります。
domain

string

ドメイン名。このフィールドは、1 つのドメインのユーザーのみを取得する場合に使用します。お客様のアカウントのすべてのドメインを返すには、代わりに customer クエリ パラメータを使用します。customer または domain パラメータのいずれかを指定する必要があります。
event

enum (Event)

定期購入が対象のイベント（定期購入の場合）
maxResults

integer

返される結果の最大数。
orderBy

enum (OrderBy)

結果の並べ替えに使用するプロパティ。
pageToken

string

リストの次のページを指定するトークン。ページトークンの有効期間は 3 日間のみです。
projection

enum (Projection)

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

string

ユーザー フィールドを検索するためのクエリ文字列。ユーザー クエリの作成の詳細については、ユーザーを検索するをご覧ください。
showDeleted

string

true に設定すると、削除されたユーザーのリストを取得します。（デフォルト: false）
sortOrder

enum (SortOrder)

結果を昇順または降順で返すか（大文字と小文字を区別しない）を指定します。
viewType

enum (ViewType)

ユーザーの管理者専用ビューとドメイン全体の公開ビューのどちらを取得するか。詳細については、管理者以外のユーザーを取得するをご覧ください。

リクエストの本文

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

レスポンスの本文

成功すると、レスポンスの本文に次の構造のデータが含まれます。

JSON 表現 
{
  "kind": string,
  "trigger_event": string,
  "etag": string,
  "users": [
    {
      object (User)
    }
  ],
  "nextPageToken": string
}
フィールド
kind

string

リソースの種類。
trigger_event

string

このレスポンスをトリガーしたイベント（プッシュ レスポンスの場合のみ使用）
etag

string

リソースの ETag。
users[]

object (User)

ユーザー オブジェクトのリスト。
nextPageToken

string

この結果の次のページにアクセスするために使用されるトークン。ページトークンの有効期間は 3 日間のみです。

認可スコープ

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

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

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

イベント

サブスクリプション イベントのタイプ

列挙型
ADD ユーザー作成イベント
DELETE ユーザーが削除したイベント
MAKE_ADMIN ユーザー管理ステータス変更イベント
UNDELETE ユーザーの削除の取り消しイベント
UPDATE ユーザーが更新したイベント

OrderBy

列挙型
EMAIL ユーザーのメインのメールアドレス。
FAMILY_NAME ユーザーの姓。
GIVEN_NAME ユーザーの名。

予測

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

SortOrder

列挙型
ASCENDING 昇順。
DESCENDING 降順。

ViewType

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