사용자 그룹 소속(GroupMembership) API (V2)

GroupMembership은 사용자가 어떤 그룹에 속하는지 나타냅니다. 사용자 ID를 경로에 지정하고 List Group Memberships로 소속 목록을 조회합니다.

응답의 각 GroupMembership에는 필수 문자열 groupId가 있습니다. 그룹 이름이나 특성이 필요하면 이 ID로 Get Group을 호출합니다.

직접 소속과 간접 소속

transitive의 기본값은 false입니다. 사용자가 그룹 A에 속하고 A가 그룹 B에 속한다면 기본 조회는 A만 반환합니다. transitive=true로 지정하면 모든 중첩 단계를 따라 A와 B를 반환합니다.

조회는 페이지 단위입니다. 실제 페이지 크기는 요청과 다를 수 있으므로 다음 페이지 여부를 nextPageToken으로 판단합니다. 첫 요청에는 pageToken을 넣지 않고 이후 요청에 직전 응답 토큰을 전달합니다.

현재 사용자만 조회할 경우

이 API의 OAuth 권한 범위는 api:admin-read입니다. 자신의 직접 및 간접 소속 그룹을 조회하는 별도 List Current Groups는 특정 OAuth 권한 범위를 요구하지 않습니다. 해당 경로는 미리보기 API이므로 인증과 preview=true가 필요합니다.

반대로 한 그룹에 속한 사용자와 하위 그룹을 확인하거나 추가 및 제거하려면 그룹 구성원 API를 사용합니다.