Membuat dan menelusuri Google Grup

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

Sebelum memulai

Lakukan tugas berikut sebelum melanjutkan dengan informasi di halaman ini:

Membuat Google Grup

REST

Untuk membuat Google Grup, 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 menyetel parameter initialGroupConfig, yang menentukan pemilik awal grup. Anda dapat menggunakan value berikut untuk parameter ini:

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

Python

Contoh berikut menunjukkan fungsi bantuan untuk membuat Google Grup 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 Google Grup, 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 bantuan yang digunakan untuk menelusuri Google Grup 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 selanjutnya