Method: users.watch

監控使用者清單的變更。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

查詢參數

參數
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

查詢字串搜尋。包含一或多個搜尋子句，每個子句都有欄位、運算子和值。如需完整說明文件，請參閱「搜尋使用者」。
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 使用者更新事件

排序依據

列舉
EMAIL 使用者的主要電子郵件地址。
FAMILY_NAME 使用者的姓氏。
GIVEN_NAME 使用者的名字。

預測值

列舉
BASIC 請勿加入任何使用者的自訂欄位。
CUSTOM 包含 customFieldMask 中提及的結構定義自訂欄位。
FULL 包含與該使用者相關聯的所有欄位。

SortOrder

列舉
ASCENDING 遞增排序。
DESCENDING 遞減排序。

ViewType

列舉
admin_view 結果會包含僅限管理員和網域公開的欄位。
domain_public 結果只會顯示網域中其他使用者可公開查看的使用者欄位。