Membuat dan memperbarui grup dinamis
Halaman ini menjelaskan cara membuat dan memperbarui grup dinamis.
Sebelum memulai
Lakukan tugas berikut sebelum melanjutkan informasi di halaman ini:
Baca Ringkasan Groups API.
Baca ringkasan grup dinamis.
(Opsional) Merumuskan dan menguji 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 Engineering:
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 mengupdate grup dinamis, panggil metode service.groups().patch
dengan
nama grup yang akan diupdate 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
Departemen Teknik 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 informasi selengkapnya, lihat Mengambil grup dinamis dan menampilkan anggota.