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 anggota listingan.