Method: roles.list

도메인의 모든 역할이 페이지로 나눈 목록을 검색합니다.

HTTP 요청

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

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

경로 매개변수

매개변수
customer

string

고객 Google Workspace 계정의 고유 ID입니다. 다중 도메인 계정의 경우 한 고객의 모든 그룹을 가져오려면 domain 대신 이 필드를 사용합니다. my_customer 별칭을 사용하여 계정의 customerId을 나타낼 수도 있습니다. customerId도 Users 리소스의 일부로 반환됩니다. customer 또는 domain 매개변수를 제공해야 합니다.

쿼리 매개변수

매개변수
maxResults

integer

반환할 결과의 최대 수입니다.
pageToken

string

목록에서 다음 페이지를 지정하는 토큰입니다.

요청 본문

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

응답 본문

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

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

string

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

string

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

object (Role)

역할 리소스의 목록입니다.
nextPageToken

string

승인 범위

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

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

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