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
Setelah grup ada, Anda dapat membuat keanggotaan untuknya. Untuk membuat keanggotaan Google Grup, lihat Mengelola keanggotaan untuk Google Grup.
Anda dapat memperbarui Google Grup menjadi grup keamanan.