Method: roleAssignments.list

擷取所有 roleAssignment 的頁面式清單。

HTTP 要求

GET https://admin.googleapis.com/admin/directory/v1/customer/{customer}/roleassignments

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

路徑參數

參數
customer

string

客戶 Google Workspace 帳戶的專屬 ID。如果是多網域帳戶，請使用這個欄位，而非 domain，為客戶擷取所有群組。您也可以使用 my_customer 別名來代表帳戶的 customerId。系統也會在 Users 資源中傳回 customerId。您必須提供 customer 或 domain 參數。

查詢參數

參數
maxResults

integer

要傳回的結果數上限。
pageToken

string

用於指定清單中下一頁的符記。
roleId

string

角色的固定 ID。如果在要求中加入這個參數，系統只會傳回包含此角色 ID 的角色指派。
userKey

string

主要電子郵件地址、別名電子郵件地址，或專屬的使用者或群組 ID。如果在要求中加入這個參數，系統只會針對這個使用者或群組傳回角色指派。
includeIndirectRoleAssignments

boolean

設為 true 時，會擷取直接和間接的角色指派。預設值為 false。您必須指定 userKey，否則系統不會納入間接角色指派。

要求主體

要求主體必須為空白。

回應主體

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "kind": string,
  "etag": string,
  "items": [
    {
      object (RoleAssignment)
    }
  ],
  "nextPageToken": string
}
欄位
kind

string

API 資源的類型。這個值一律是 admin#directory#roleAssignments。
etag

string

資源的 ETag。
items[]

object (RoleAssignment)

RoleAssignment 資源清單。
nextPageToken

string

授權範圍

需要下列其中一種 OAuth 範圍：

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

詳情請參閱授權指南。