Google 그룹스 만들기 및 검색

이 페이지에서는 Cloud Identity Groups API를 사용하여 기본적인 작업을 수행하는 방법을 설명합니다.

시작하기 전에

이 페이지의 정보를 계속 진행하기 전에 다음 작업을 수행하세요.

Google 그룹 만들기

REST

Google 그룹을 만들려면 새 그룹의 인스턴스로 groups.create()를 호출합니다. 그룹 인스턴스에는 cloudidentity.googleapis.com/groups.discussion_forum로 설정된 groupKey, Parent, label이 포함되어야 합니다.

또한 그룹 초기 소유자를 정의하는 initialGroupConfig 매개변수를 설정해야 합니다. 이 매개변수에는 다음 값을 사용할 수 있습니다.

  • WITH_INITIAL_OWNER: 요청을 보내는 사람을 그룹 소유자로 지정합니다. 대부분의 경우 이 값을 사용해야 합니다.
  • EMPTY: 초기 소유자가 없는 그룹을 만듭니다. 이 값은 Google Workspace 최고 관리자 또는 그룹 관리자인 경우에만 사용합니다. Google Workspace 역할에 대한 자세한 내용은 기본 제공 관리자 역할을 참조하세요.

Python

다음 예시에서는 Python 클라이언트 라이브러리를 사용하여 Google 그룹을 만드는 도우미 함수가 나와 있습니다.

def create_google_group(service, customer_id, group_id, group_display_name, group_description):
  group_key = {"id": group_id}
  group = {
    "parent": "customers/" + customer_id,
    "description": group_description,
    "displayName": group_display_name,
    "groupKey": group_key,
    # Set the label to specify creation of a Google Group.
    "labels": {
      "cloudidentity.googleapis.com/groups.discussion_forum": ""
    }
  }

  try:
    request = service.groups().create(body=group)
    request.uri += "&initialGroupConfig=WITH_INITIAL_OWNER"
    response = request.execute()
    print(response)
  except Exception as e:
    print(e)

Google 그룹 검색

REST

Google 그룹을 검색하려면 쿼리 문자열로 groups.search()를 호출합니다. 모든 그룹을 검색하려면 cloudidentity.googleapis.com/groups.discussion_forum 라벨만 제공하면 됩니다.

Python

다음 예시에서는 Python 클라이언트 라이브러리를 사용하여 Google 그룹을 검색하는 데 사용되는 도우미 함수를 보여줍니다.

from urllib.parse import urlencode

def search_google_groups(service, customer_id):
  search_query = urlencode({
          "query": "parent=='customerId/{}' && 'cloudidentity.googleapis.com/groups.discussion_forum' in labels".format(customer_id)
  })
  search_group_request = service.groups().search()
  param = "&" + search_query
  search_group_request.uri += param
  response = search_group_request.execute()

  return response

다음 단계