멤버십 만료 관리

이 페이지에서는 그룹 멤버십의 만료 설정을 업데이트 및 검색하는 방법과 그룹 소유자가 수신하는 만료 알림을 설명합니다.

멤버십 만료를 통해 그룹 소유자, 그룹 관리자, Google Workspace 최고 관리자, 그룹 관리자 권한이 있는 Workspace 위임된 관리자는 그룹 및 그룹 기반 리소스 액세스 권한을 관리할 수 있습니다. 구성원을 수동으로 삭제하지 않고도 멤버십 비활성 또는 일시적인 필요에 따라 액세스가 제한될 수 있습니다. Groups API는 다음 사용 사례에 대해 멤버십 만료를 사용 설정합니다.

  • 리소스에 대한 한시적인 액세스 권한(예: 프로덕션의 문제 해결을 도울 수 있도록 다른 사람을 허용하는 경우)
  • 커뮤니케이션 그룹의 임시 멤버십(예: 장기 프로젝트의 팀 그룹에 사용자를 간단히 포함하는 경우)

MEMBER 역할이 있는 경우 모든 유형의 그룹 구성원(사용자, 그룹, 서비스 계정 포함)에게 만료를 적용할 수 있습니다. 그룹 구성원에 만료를 설정하면 하위 구성원이 개별 만료가 이미 적용된 상위 그룹에 직속 멤버십이 없는 한 이 만료는 해당 그룹의 모든 하위 구성원에 대한 기본 만료가 됩니다. 만료 시간은 앞으로 하위 그룹의 모든 신규 구성원에게도 적용됩니다.

시작하기 전에

인증을 설정하고 클라이언트 라이브러리를 설치합니다. 자세한 내용은 Cloud ID 그룹스 API 설정을 참조하세요.

만료 시간이 있는 멤버십 추가

자세한 방법은 Google 그룹스의 Google 그룹 멤버십 관리 또는 ID 매핑 그룹 멤버십 관리를 참조하세요.

멤버십 만료 업데이트

멤버십 만료를 업데이트하려면 상위 그룹의 ID, 멤버십 ID, UpdateMembershipRolesParams 리소스를 사용하여 groups.memberships.modifyMembershipRoles()을 호출합니다. 구성원은 그룹에 둘 이상의 MembershipRole을 가질 수 있으므로 만료일이 있는 역할을 지정해야 합니다. 현재 MEMBER 역할만 만료 시간이 적용될 수 있습니다.

샘플 요청 본문

{
  "updateRolesParams": [
    {
      "fieldMask": "expiry_detail.expire_time",
      "membershipRole": {
        "expiryDetail": {
          "expireTime": "2021-10-02T15:01:23Z"
        },
        "name": "MEMBER"
      }
    }
  ]
}

멤버십 만료일 검색

멤버십의 멤버십 만료일을 검색하려면 상위 그룹의 ID와 멤버십 ID를 사용하여 groups.memberships.get()를 호출합니다.

이메일 알림

멤버십 만료 시기가 되면 모든 그룹 소유자에게 이메일 알림이 자동으로 전송됩니다. 알림은 만료 72시간 전 또는 멤버십 설정 시 72시간 이전에 멤버십이 만료되는 경우 즉시 전송됩니다. 알림은 Google 관리 콘솔의 도메인 관리자 또는 그룹 소유자가 개별적으로 정의한 대로 각 그룹 소유자가 선호하는 언어로 전송됩니다.