Membuat dan menelusuri Google Grup

Halaman ini menjelaskan cara melakukan beberapa operasi mendasar dengan Cloud Identity Groups API.

Sebelum memulai

Lakukan tugas berikut sebelum melanjutkan informasi di halaman ini:

Membuat Grup Google

REST

Untuk membuat Grup Google, panggil groups.create() dengan instance grup baru. Instance grup harus menyertakan groupKey, Parent, dan label yang ditetapkan ke cloudidentity.googleapis.com/groups.discussion_forum.

Anda juga perlu menetapkan parameter initialGroupConfig, yang menentukan pemilik awal grup. Anda dapat menggunakan nilai berikut untuk parameter ini:

  • WITH_INITIAL_OWNER: Menjadikan orang yang mengirim permintaan sebagai pemilik grup. Anda harus menggunakan nilai ini dalam sebagian besar kasus.
  • EMPTY: Membuat grup tanpa pemilik awal. Anda hanya dapat menggunakan nilai ini jika Anda adalah Admin Super atau Admin Grup Google Workspace. Untuk mengetahui informasi selengkapnya tentang peran Google Workspace, lihat Peran administrator standar.

Python

Contoh berikut menunjukkan fungsi helper untuk membuat Grup Google menggunakan library klien Python:

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)

Menelusuri Google Grup

REST

Untuk menelusuri Grup Google, panggil groups.search() dengan string kueri. Untuk menelusuri semua grup, Anda hanya perlu memberikan label cloudidentity.googleapis.com/groups.discussion_forum.

Python

Contoh berikut menunjukkan fungsi helper yang digunakan untuk menelusuri Grup Google menggunakan library klien Python:

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

Langkah berikutnya