그룹 구성원(GroupMember) API (V2)

GroupMember는 그룹에 속한 사용자 또는 다른 그룹을 나타냅니다. 특정 사용자가 어떤 그룹에 속하는지를 보여 주는 GroupMembership과 조회 방향이 다릅니다.

필드	자료형	조건
`principalType`	`USER` 또는 `GROUP`	필수, 구성원의 종류
`principalId`	`string`	필수, 사용자 또는 그룹 ID
`expiration`	`string (date-time)`	선택, 목록 조회에서 `includeExpirations=true`일 때만 만료 시각 포함 가능

구성원 조회

List Group Members는 사용자와 하위 그룹 구성원을 페이지 단위로 반환합니다. transitive=false가 기본값이며 true로 지정하면 중첩된 그룹의 구성원도 재귀적으로 조회합니다.

만료 시각을 조회하려면 includeExpirations=true를 지정합니다. 재귀 조회와 만료 시각 포함을 함께 켤 수 없습니다. transitive=true로 조회할 때는 includeExpirations를 생략합니다.

Add Group Members는 principalIds 목록의 사용자나 그룹을 구성원으로 추가합니다. 선택적인 expiration 값은 그룹 소속 만료 정책의 제약을 충족해야 합니다.

Remove Group Members는 지정한 사용자나 그룹을 구성원 목록에서 제거합니다. 사용자 계정이나 그룹 리소스를 삭제하는 API와 구분합니다.

조회에는 api:admin-read, 구성원 추가와 제거에는 api:admin-write OAuth 권한 범위를 요청합니다.