Google 그룹스 멤버십 관리

그룹이 존재하면 그룹의 멤버십을 만들 수 있습니다. 이 페이지에서는 Cloud ID 그룹스 API를 사용하여 기본적인 멤버십 작업을 수행하는 방법을 설명합니다. Google 그룹을 만드는 방법은 Google 그룹스 만들기 및 검색하기를 참조하세요.

시작하기 전에

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

Google 그룹에 멤버십 추가

REST

Google 그룹에 구성원을 추가하려면 상위 그룹의 ID 및 멤버십 리소스를 사용하여 groups.memberships.create()를 호출합니다. expiryDetail은 멤버십 만료를 설정하기 위해 추가할 수 있는 필드(선택사항)입니다.

샘플 요청 본문

{
  "preferredMemberKey": {
    "id": "techwriter@example.com"
  },
  "roles": [
    {
      "expiryDetail": {
        "expireTime": "2021-10-02T15:01:23Z"
      },
      "name": "MEMBER"
    }
  ]
}

Python

다음 코드는 그룹에 멤버십을 추가하는 방법을 보여줍니다. expiryDetail은 멤버십 만료를 설정하기 위해 추가할 수 있는 필드(선택사항)입니다.

def create_google_group_membership(service, identity_source_id, group_id, member_key):
  param = "&groupKey.id=" + group_id + "&groupKey.namespace=identitysources/" + identity_source_id
  try:
    lookupGroupNameRequest = service.groups().lookup()
    lookupGroupNameRequest.uri += param
    # Given a group ID and namespace, retrieve the ID for parent group
    lookupGroupNameResponse = lookupGroupNameRequest.execute()
    groupName = lookupGroupNameResponse.get("name")
    # Create a membership object with a memberKey and a single role of type MEMBER
    membership = {
      "preferredMemberKey": member_key,
      "roles" : {
        "name" : "MEMBER",
        "expiryDetail": {
          "expireTime": "2021-10-02T15:01:23Z"
        }
      }
    }
    # Create a membership using the ID for the parent group and a membership object
    response = service.groups().memberships().create(parent=groupName, body=membership).execute()
    print response
  except Exception, e:
    print e

Google 그룹의 멤버십 나열

REST

Google 그룹의 멤버십을 나열하려면 상위 그룹의 ID 및 멤버십 리소스를 사용하여 groups.memberships.list()를 호출합니다.

Python

다음 코드는 그룹의 멤버십을 나열합니다.

def list_google_group_memberships(service, group_id):
  param = "&groupKey.id=" + group_id
  try:
    lookup_group_name_request = service.groups().lookup()
    lookup_group_name_request.uri += param
    lookup_group_name_response = lookup_group_name_request.execute()
    group_name = lookup_group_name_response.get("name")
    # List memberships
    response = service.groups().memberships().list(parent=group_name).execute()
    print response
  except Exception, e:
    print e