Membuat dan memperbarui grup dinamis
Halaman ini menjelaskan cara membuat dan memperbarui grup dinamis.
Sebelum memulai
Lakukan tugas berikut sebelum melanjutkan dengan informasi di halaman ini:
Baca ringkasan Groups API.
Baca ringkasan grup dinamis.
(Opsional) Rumuskan dan uji kueri keanggotaan.
Membuat grup dinamis
Berikut adalah contoh pembuatan grup dinamis:
REST
Untuk membuat grup dinamis, panggil
groups.create()
dengan instance grup. Instance grup harus berisi
dynamicGroupMetadata
dengan kueri yang digunakan untuk mengisi grup.
Python
Untuk membuat grup dinamis, panggil metode service.groups().create
dengan
instance grup. Instance grup harus berisi
dynamicGroupMetadata
dengan kueri yang digunakan untuk mengisi grup. Contoh berikut menunjukkan cara membuat grup dinamis yang berisi semua pengguna yang ada di departemen Teknik:
def create_dynamic_group(customer_id, email, query):
service = build_service()
groupDef = {
"parent": "customerId/{}".format(customer_id),
"groupKey": {"id": email},
"labels": {"cloudidentity.googleapis.com/groups.discussion_forum": ""},
"dynamicGroupMetadata": {
"queries": [
{
"resourceType": "USER",
"query": "user.organizations.exists(org, org.department=='engineering')"
}
]
}
}
request = service.groups().create(body=groupDef)
request.uri += "&initialGroupConfig=EMPTY"
response = request.execute()
return response
Memperbarui grup dinamis
Berikut adalah contoh pembaruan grup dinamis:
REST
Untuk memperbarui grup dinamis, panggil
groups.patch()
dengan instance grup. Instance grup harus berisi
dynamicGroupMetadata
dengan kueri baru yang digunakan untuk mengisi grup.
Python
Untuk memperbarui grup dinamis, panggil metode service.groups().patch
dengan
nama grup yang akan diperbarui dan instance grup. Instance
grup harus berisi
dynamicGroupMetadata
dengan kueri yang digunakan untuk mengisi grup. Contoh berikut menunjukkan cara memperbarui grup dinamis yang berisi semua pengguna di bagian Engineering ke grup yang berisi semua pengguna di departemen Teknik atau Keuangan:
# name (i.e. groups/01234abcdeef) uniquely identifies the group
def update_dynamic_group(name, query):
service = build_service()
groupDef = {
"dynamicGroupMetadata": {
"queries": [
{
"resourceType": "USER",
"query": "user.organizations.exists(org, org.department=='engineering' || org.department=='finance')"
}
]
}
}
request = service.groups().patch(name=name, body=groupDef)
request.uri += "&updateMask=dynamicGroupMetadata"
response = request.execute()
return response
Langkah selanjutnya
Setelah grup dinamis ada, Anda dapat mengambilnya dan mencantumkan keanggotaannya. Untuk mengetahui informasi selengkapnya, baca artikel Mengambil grup dinamis dan anggota listingan.