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

자세한 내용은 OAuth 2.0 개요를 참고하세요.