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 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 menetapkan parameter initialGroupConfig, yang menentukan pemilik awal grup. Anda dapat menggunakan nilai berikut untuk parameter ini:

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

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 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 bantuan 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 selanjutnya