Mengonfigurasi ruang dan anggota rapat

Ruang rapat mewakili tempat virtual atau objek persisten (seperti ruang rapat) tempat konferensi diadakan. Ruang rapat juga membantu pengguna bertemu dan menemukan referensi bersama.

Saat Anda membuat ruang rapat menggunakan metode spaces.create, metode tersebut akan menampilkan instance resource spaces. Resource ini mencakup objek SpaceConfig yang merupakan konfigurasi untuk ruang rapat. File ini juga berisi objek ActiveConference yang merupakan link ke resource conferenceRecords saat ini dalam ruang rapat.

Bagian berikut menjelaskan cara mengonfigurasi ruang rapat menggunakan beberapa objek dan metode beta baru.

Menetapkan moderasi dan akses rapat

Melalui objek beta baru, Anda kini dapat menetapkan mode moderasi, pembatasan fitur, dan izin yang diterima pengguna saat mereka bergabung ke rapat. Nilai ini ditetapkan melalui objek SpaceConfig yang diperbarui.

Kolom moderation adalah mode moderasi yang telah dikonfigurasi sebelumnya untuk rapat, dengan default yang dikontrol oleh kebijakan pengguna. Class ini menggunakan objek Moderation. Jika mode moderasi aktif, pemilik rapat memiliki kontrol atas rapat dengan fitur seperti pengelolaan rekan penyelenggara (lihat spaces.members) dan batasan fitur (lihat moderationRestrictions). Untuk informasi selengkapnya tentang anggota, lihat Mengelola anggota ruang.

Kolom moderationRestrictions menerapkan batasan moderasi untuk rapat saat moderation aktif. Class ini menggunakan objek ModerationRestrictions. Pembatasan ini menentukan siapa yang memiliki izin untuk mengirim pesan dan reaksi chat, membagikan layar, dan apakah akan membatasi peran default yang ditetapkan kepada pengguna sebagai penonton. Kolom moderationRestrictions bergantung pada RestrictionType untuk menerapkan tiga batasan pertama. RestrictionType dapat diterapkan ke pemilik dan rekan penyelenggara rapat, atau ke semua peserta. DefaultJoinAsViewerType menerapkan izin akhir saat pengguna bergabung sebagai kontributor secara default, tetapi penyelenggara juga dapat membatasi pengguna untuk bergabung sebagai penonton.

Kolom firstJoinerType menetapkan apakah pengguna dapat bergabung sebelum penyelenggara untuk konferensi di ruang rapat ini. Fitur ini menentukan pengguna mana yang dapat bergabung ke rapat terlebih dahulu dan apakah pengguna lain dalam status menunggu. Class ini menggunakan objek FirstJoinerType.

Mengelola anggota ruang

Pemilik rapat selalu dapat bergabung ke rapat tanpa perlu meminta izin masuk, tetapi kini Anda dapat mengonfigurasi anggota yang juga dapat bergabung ke rapat tanpa perlu meminta izin masuk. Selain itu, anggota dapat dikonfigurasi untuk memiliki peran dalam rapat, seperti COHOST yang memberi mereka kemampuan yang sama untuk mengelola rapat seperti pemilik rapat. Untuk mengetahui informasi selengkapnya tentang cara mengakses ruang rapat tanpa mengetuk, lihat AccessType.

Resource spaces.members mencakup kolom name, user, dan role.

Perhatikan bahwa anggota berbeda dengan peserta. Peserta adalah orang yang bergabung ke panggilan atau yang menggunakan mode Pendamping , menonton sebagai pelihat, atau perangkat ruang yang terhubung ke panggilan. Ada satu resource conferenceRecords.participants untuk setiap orang.

Anda dapat mengelola anggota ruang menggunakan metode berikut:

Setiap metode menggunakan parameter jalur dengan metode create dan list menggunakan kolom parent untuk menunjukkan ruang rapat, dan metode delete dan get menggunakan kolom name untuk memfilter hasil berdasarkan ruang rapat dan nama anggota.

Semua metode, kecuali hapus, mendukung parameter fields di SystemParameterContext . Jika parameter fields dihilangkan, respons API akan ditetapkan secara default ke "name,email,role,user".

Parameter fields mengandalkan FieldMask untuk pemfilteran respons. FieldMask adalah cara bagi pemanggil API untuk mencantumkan kolom yang harus ditampilkan oleh permintaan. Ini adalah daftar kolom yang dipisahkan koma untuk menentukan hanya kolom tertentu dalam objek yang digunakan, sementara kolom lainnya tidak diubah. Penggunaan FieldMask memungkinkan API menghindari pekerjaan yang tidak perlu dan meningkatkan performa. Mask kolom digunakan untuk metode create, get, dan list. Untuk informasi selengkapnya tentang mask kolom, lihat Menggunakan mask kolom Google Spreadsheet API.