Method: users.watch

ユーザーリストの変更を監視します。

HTTP リクエスト

POST https://admin.googleapis.com/admin/directory/v1/users/watch

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

クエリ パラメータ

パラメータ
domain

string

ドメインの名前。このフィールドに入力すると、このドメインのユーザーのみを取得できます。代わりに、マルチドメインの [顧客] フィールドにすべてのユーザーを返すようにします。」
customer

string

Google Workspace アカウントの不変 ID。複数ドメインの場合、お客様のすべてのユーザーを取得するには、ドメインではなくこのフィールドに入力します。
event

enum (EventType)

注意すべきイベント。
customFieldMask

string

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

integer

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

enum (OrderBy)

結果の並べ替えに使用する列
pageToken

string

リストの次のページを指定するトークン
projection

enum (Projection)

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

string

クエリ文字列検索。「」の形式にする必要があります。詳細なドキュメントは、https: //developers.google.com/workspace/admin/directory/v1/guides/search-users をご覧ください。
showDeleted

string

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

enum (SortOrder)

結果を昇順または降順のどちらで返すかを指定します。
viewType

enum (ViewType)

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

リクエストの本文

リクエストの本文には SubscriptionChannel のインスタンスが含まれます。

レスポンスの本文

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

認可スコープ

以下のいずれかの 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

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

EventType

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

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

OrderBy

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

予測

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

SortOrder

列挙型
ASCENDING 昇順。
DESCENDING 降順。

ViewType

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