擷取網域中已刪除或所有使用者的分頁清單。
HTTP 要求
GET https://admin.googleapis.com/admin/directory/v1/users
這個網址使用 gRPC 轉碼語法。
查詢參數
參數 | |
---|---|
customFieldMask |
以半形逗號分隔的結構定義名稱清單。系統會擷取這些結構定義中的所有欄位。只有在 |
customer |
客戶的 Google Workspace 帳戶專屬 ID。如果是多重網域帳戶,請使用這個欄位 (而不是 |
domain |
網域名稱。您可以使用這個欄位從一個網域取得群組。如要傳回客戶帳戶的所有網域,請改用 |
event |
要指定訂閱項目的事件 (如訂閱) |
maxResults |
要傳回的結果數上限。 |
orderBy |
用於排序結果的屬性。 |
pageToken |
用於指定清單下一頁的符記 |
projection |
要為這位使用者擷取的欄位子集。 |
query |
用於搜尋使用者欄位的查詢字串。如要進一步瞭解如何建構使用者查詢,請參閱「搜尋使用者」。 |
showDeleted |
如果設為 |
sortOrder |
要以遞增或遞減順序傳回結果,不區分大小寫。 |
viewType |
選擇要擷取使用者的專屬公開檢視畫面,或套用至整個網域。詳情請參閱以非管理員的身分擷取使用者。 |
要求主體
要求主體必須為空白。
回應主體
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{
"kind": string,
"trigger_event": string,
"etag": string,
"users": [
{
object ( |
欄位 | |
---|---|
kind |
此為資源種類。 |
trigger_event |
觸發此回應的事件 (僅適用於推送回應) |
etag |
資源的 ETag。 |
users[] |
使用者物件清單。 |
nextPageToken |
存取此結果下一頁的權杖。 |
授權範圍
需要下列其中一種 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 |
結果只包含網域內其他使用者能公開檢視的欄位。 |