Method: members.list

그룹의 모든 회원 목록을 페이지로 나눈 형식으로 가져옵니다. 이 메서드는 60분 후에 타임아웃됩니다. 자세한 내용은 오류 코드 문제 해결을 참고하세요.

HTTP 요청

GET https://admin.googleapis.com/admin/directory/v1/groups/{groupKey}/members

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

경로 매개변수

매개변수
groupKey

string

API 요청에서 그룹을 식별합니다. 값은 그룹의 이메일 주소, 그룹 별칭 또는 고유 그룹 ID일 수 있습니다.

쿼리 매개변수

매개변수
includeDerivedMembership

boolean

간접 멤버십을 표시할지 여부입니다. 기본값: false.
maxResults

integer

반환할 결과의 최대 수입니다. 허용되는 최대 값은 200입니다.
pageToken

string

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

string

roles 쿼리 매개변수를 사용하면 역할별로 그룹 구성원을 검색할 수 있습니다. 허용되는 값은 OWNER, MANAGER, MEMBER입니다.

요청 본문

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

응답 본문

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

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

string

리소스 유형입니다.
etag

string

리소스의 ETag입니다.
members[]

object (Member)

구성원 객체 목록입니다.
nextPageToken

string

이 결과의 다음 페이지에 액세스하는 데 사용되는 토큰입니다.

승인 범위

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

  • https://apps-apis.google.com/a/feeds/groups/
  • https://www.googleapis.com/auth/admin.directory.group
  • https://www.googleapis.com/auth/admin.directory.group.member
  • https://www.googleapis.com/auth/admin.directory.group.member.readonly
  • https://www.googleapis.com/auth/admin.directory.group.readonly

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