Method: roleAssignments.list

모든 roleAssignments를 페이지로 나눈 목록을 검색합니다.

HTTP 요청

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

URL은 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입니다. 요청에 포함된 경우 이 사용자 또는 그룹에 대한 역할 할당만 반환합니다.
includeIndirectRoleAssignments

boolean

true로 설정하면 간접 역할 할당 (즉, 그룹을 통한 역할 할당)과 직접 역할 할당을 가져옵니다. 기본값은 false입니다. userKey을(를) 지정해야 합니다. 그렇지 않으면 간접 역할 할당이 포함되지 않습니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "kind": string,
  "etag": string,
  "items": [
    {
      object (RoleAssignment)
    }
  ],
  "nextPageToken": string
}
필드
kind

string

API 리소스의 유형입니다. 항상 admin#directory#roleAssignments입니다.
etag

string

리소스의 eETag입니다.
items[]

object (RoleAssignment)

RoleAssignment 리소스의 목록입니다.
nextPageToken

string

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

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

자세한 내용은 승인 가이드를 참조하세요.