Google 그룹스 만들기 및 검색
이 페이지에서는 Cloud ID 그룹스 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
다음 단계
그룹이 존재하면 그룹의 멤버십을 만들 수 있습니다. Google 그룹의 멤버십을 만들려면 Google 그룹스 멤버십 관리를 참조하세요.
Google 그룹을 보안 그룹으로 업데이트할 수 있습니다.