Google グループの作成と検索

このページでは、Cloud Identity Groups API を使用して基本的なオペレーションを行う方法について説明します。

始める前に

次の作業を実施した後、このページの内容に進んでください。

Google グループを作成する

REST

Google グループを作成するには、groups.create を呼び出して新しいグループのインスタンスを指定します。グループ インスタンスには、cloudidentity.googleapis.com/discussion_forums に設定された groupKeyParentlabel を含める必要があります。

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)

管理コンソールで ID ソースを作成する際に取得したソース ID を使用してヘルパー関数を呼び出し、グループを作成します。


idSvc = build_google_group()

myNewGroup = create_google_group(
  idSvc,
  "ABC1234",
  "eng",
  "Engineering Google Group",
  "The Engineering group is a Google Group for all engineers in our company"
)

Google グループを検索する

REST

Google グループを検索するには、groups.search を呼び出してクエリ文字列を指定します。ラベル cloudidentity.googleapis.com/discussion_forums を指定すると、すべてのグループを検索できます。

Python

Python クライアント ライブラリを使用して Google グループを検索するために使用されるヘルパー関数を、次の例に示します。

def search_google_groups(service, identity_source_id, pageSize, view):
  # Set the label to search for all Google groups
  searchQuery = "&query=labels:cloudidentity.googleapis.com/discussion_forums" \
    + "&pageSize=" + pageSize + "&view=" + view
  try:
    searchGroupsRequest = service.groups().search()
    searchGroupsRequest.uri += searchQuery
    response = searchGroupsRequest.execute()
    print response
  except Exception, e:
    print e

次のステップ

グループを作成したら、そのグループのメンバーを作成できます。Google グループのメンバーを作成するには、Google グループのメンバーを管理するをご覧ください。