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.