Method: roleAssignments.list

擷取所有 roleAssignments 的分頁清單。

HTTP 要求

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

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

路徑參數

參數
customer

string

客戶 Google Workspace 帳戶的專屬 ID。在多網域帳戶的情況下,如要擷取客戶的所有群組,請使用這個欄位,而不是 domain。您也可以使用 my_customer 別名代表帳戶的customerIdcustomerId 也會做為 Users 資源的一部分傳回。您必須提供 customerdomain 參數。

查詢參數

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

詳情請參閱授權指南