Mengelola ruang Google Chat sebagai administrator Google Workspace

Halaman ini memberikan ringkasan tentang cara administrator Google Workspace menggunakan Google Chat API untuk mengelola ruang Google Chat di seluruh organisasi mereka.

Untuk mengelola ruang Chat, administrator Google Workspace dapat menggunakan Alat Pengelolaan Ruang di konsol Google Admin atau memanggil Google Chat API. Dengan menggunakan Chat API, administrator dapat membuat aplikasi Google Chat yang mengelola ruang dalam skala besar dan mengotomatiskan tugas umum atau berulang.

Yang dapat dilakukan administrator dengan Chat API

Administrator dapat melakukan tugas pengelolaan berdasarkan peran administrator yang ditetapkan.

Sebagai administrator Google Workspace, Anda dapat melakukan sejumlah tugas pengelolaan dengan Chat API, seperti berikut:

Cara mengautentikasi dan memberikan otorisasi sebagai administrator Google Workspace

Saat menggunakan Chat API untuk tugas pengelolaan, administrator dapat mengautentikasi dan memberikan otorisasi permintaan dengan memanggil hak istimewa administrator atau mengonfigurasi delegasi seluruh domain otoritas untuk akun layanan aplikasi.

Tabel berikut menjelaskan cara administrator dapat melakukan autentikasi saat menggunakan Chat API.

Autentikasi pengguna Siapa yang memanggil metode API Yang dilihat pengguna di Chat
Hak istimewa administrator Administrator dengan useAdminAccess=true

"Administrator organisasi melakukan [tindakan]."

Misalnya, "Administrator organisasi mengubah peran Kiran B menjadi pengelola ruang".

ID ini tidak mengidentifikasi nama pengguna administrator atau ID pengguna atau nama aplikasi Chat.
Delegasi tingkat domain Akun layanan atas nama pengguna

"[Pengguna] melakukan [tindakan] melalui [nama aplikasi]."

Misalnya, "Sasha T mengganti nama ruang menjadi Diskusi Project Rilis".

Pengguna yang diimpersonasi oleh layanan diidentifikasi sebagai telah melakukan tindakan.

Menggunakan Chat API untuk organisasi Anda

Contoh di bagian ini menunjukkan cara administrator menggunakan Chat API saat mengelola ruang dan anggota organisasi mereka dengan hak istimewa administrator.

Metode Chat API berikut mengaktifkan hak istimewa administrator dengan useAdminAccess=true.

Mengelola keanggotaan ruang pengguna

Skenario berikut adalah cara Anda, sebagai administrator Google Workspace, dapat mengelola keanggotaan ruang pengguna di organisasi Anda dengan Chat API.

Menambahkan pengguna ke ruang

Dengan spaces.members.create(), admin dapat menambahkan pengguna ke ruang mana pun di organisasi.

Jika digunakan bersama dengan spaces.search(), admin dapat menambahkan pengguna ke serangkaian ruang yang ditentukan oleh kueri penelusuran mereka. Hal ini dapat berguna saat melakukan orientasi untuk karyawan baru di organisasi; hal ini memungkinkan administrator mengotomatiskan proses rutin.

Menemukan pengguna dan menghapusnya dari ruang

Dengan menggunakan spaces.members.get(), admin dapat menentukan apakah pengguna (internal atau eksternal organisasi) adalah anggota ruang mana pun di organisasi.

Jika digunakan bersama dengan spaces.search(), admin dapat menemukan semua ruang tempat pengguna menjadi anggota, lalu menghapusnya dari ruang dengan spaces.members.delete(). Hal ini dapat berguna saat karyawan berpindah tim dalam organisasi atau saat karyawan yang tidak lagi bekerja di organisasi melakukan proses offboarding. Hal ini memungkinkan administrator mengotomatiskan proses rutin.

Mempromosikan pengguna menjadi pengelola ruang

Dengan menggunakan spaces.members.patch(), admin dapat mempromosikan anggota ruang dari ROLE_MEMBER menjadi ROLE_MANAGER. Admin juga dapat menggunakan spaces.members.patch() untuk memindahkan anggota dari ROLE_MANAGER ke ROLE_MEMBER.

Jika digunakan bersama dengan spaces.search(), admin dapat menemukan ruang yang tidak memiliki pengelola, lalu mempromosikan anggota yang ada ke ROLE_MANAGER dengan spaces.members.patch().

Menemukan anggota eksternal ruang

Dengan spaces.members.list(), admin dapat mengambil daftar anggota di ruang, mengambil profil pengguna dari People API atau Directory API organisasi, lalu memfilter hasil untuk mereka yang merupakan anggota domain atau organisasi eksternal. Untuk mengetahui informasi selengkapnya, lihat Cara chat mengidentifikasi pengguna.

Mengaudit dan mengelola ruang

Skenario berikut adalah cara Anda, sebagai administrator Google Workspace, dapat mengaudit dan mengelola ruang di organisasi dengan Chat API.

Menemukan dan menghapus ruang yang tidak aktif

Ruang Chat yang tidak digunakan dapat menghabiskan ruang penyimpanan yang berharga dan membuat antarmuka pengguna berantakan. Admin dapat menggunakan spaces.search() untuk menemukan ruang yang tidak aktif, lalu spaces.delete() untuk menghapusnya. Untuk panduan lebih lanjut dan contoh kode, lihat Menemukan dan menghapus ruang Chat yang tidak aktif.

Mengaudit ruang di organisasi

Dengan menggunakan spaces.search(), admin dapat mengambil daftar semua ruang di organisasi dengan informasi mendetail tentang setelan dan metadata setiap ruang seperti tanggal pembuatan, tanggal aktivitas terakhir, jumlah anggota, status setelan histori, dan kemampuan untuk mengundang tamu eksternal.

Mengekspor daftar ruang berdasarkan kriteria penelusuran

Dengan menggunakan spaces.search(), admin dapat mengambil daftar ruang yang memenuhi kriteria yang ditentukan dalam query dan mengekspor hasilnya ke file CSV untuk dianalisis.

Menemukan anggota ruang berdasarkan kriteria penelusuran

Dengan menggunakan spaces.members.list(), admin dapat mengambil daftar anggota untuk ruang mana pun di organisasi dan menganalisis hasilnya berdasarkan kriteria tertentu.

Menemukan pengelola ruang

Dengan menggunakan spaces.members.list(), admin dapat mengambil daftar anggota untuk ruang yang difilter ke MembershipState=ROLE_MANAGER.

Untuk menemukan semua pengelola ruang di organisasi, di semua ruang, Anda dapat menggunakan spaces.search() untuk mencantumkan semuanya. Kemudian, untuk setiap ruang dalam daftar, gunakan spaces.members.list untuk mengambil pengelola.