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。customerId 也会作为 Users 资源的一部分返回。您必须提供 customer 或 domain 参数。

查询参数

参数
maxResults

integer

返回的结果数上限。
pageToken

string

用于指定列表中的下一页的令牌。
roleId

string

角色的不可变 ID。如果包含在请求中，则仅返回包含此角色 ID 的角色分配。
userKey

string

主电子邮件地址、别名电子邮件地址或唯一用户 ID 或群组 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

如需了解详情，请参阅授权指南。