Method: roleAssignments.list

모든 역할 할당의 페이징된 목록을 가져옵니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
customer

string

고객의 Google Workspace 계정의 고유 ID입니다. 다중 도메인 계정의 경우 고객의 모든 그룹을 가져오려면 domain 대신 이 필드를 사용하세요. my_customer 별칭을 사용하여 계정의 customerId를 나타낼 수도 있습니다. 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

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