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.
(Opsional) Rumuskan dan uji kueri keanggotaan.
Membuat grup dinamis
Berikut adalah contoh cara membuat 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 cara memperbarui 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 departemen Teknik menjadi 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 berikutnya
Setelah grup dinamis ada, Anda dapat mengambilnya dan mencantumkan keanggotaannya. Untuk mengetahui informasi selengkapnya, lihat Mengambil grup dinamis dan mencantumkan anggota.