그룹 소속 만료 정책 API (V2)
GroupMembershipExpirationPolicy는 사용자 또는 그룹이 구성원으로 속해 있을 수 있는 기간을 제한합니다. 모든 그룹에 정책이 있지만 그룹 소유자가 조건을 설정하기 전에는 제약이 비어 있습니다.
제약 필드
| 필드 | 자료형과 단위 | 조건 |
|---|---|---|
maximumDuration | long, 초 | 선택. 구성원 추가 시점부터 만료까지의 기간이 이 값 미만이어야 함 |
maximumValue | string (date-time) | 선택. 만료 시각이 이 값보다 앞서야 함 |
두 조건을 함께 설정하면 둘 다 충족해야 합니다. 상한과 같은 만료 시각이나 기간은 조건을 충족하지 않습니다.
가상 정책이 maximumDuration=30, maximumValue="2026-01-31T00:00:00.000Z"라면 30초 미만의 기간과 절대 시각 상한을 함께 적용합니다. 추가 시점을 2026-01-30T23:59:45.000Z로 가정하고 만료 시각을 23:59:59.000Z로 지정하면 14초 뒤이면서 절대 상한보다 1초 앞섭니다. 실제 요청에는 해당 그룹과 요청 시점에 맞는 값을 사용합니다.
정책 조회와 교체
- Get Group Membership Expiration Policy는 정책을 조회합니다. OAuth 권한 범위는
api:admin-read입니다. - Replace Group Membership Expiration Policy는 정책을 교체합니다. OAuth 권한 범위는
api:admin-write입니다.
두 엔드포인트는 미리보기 기능이며 언제든 변경되거나 제거될 수 있습니다. 호출할 때 preview=true를 지정합니다.
구성원을 추가할 때의 만료값이 조건을 충족하지 않으면 Add Group Members에서 InvalidGroupMembershipExpiration 오류를 확인할 수 있습니다. 구성원의 만료 시각을 조회하는 조건은 GroupMember API를 따릅니다.