Ruang rapat mewakili tempat virtual atau objek persisten (seperti ruang rapat) tempat konferensi dilaksanakan. Ruang rapat juga membantu pengguna bertemu dan menemukan referensi bersama.
Saat Anda membuat ruang rapat menggunakan metode spaces.create(), metode ini 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. Untuk informasi selengkapnya tentang cara mengelola ruang rapat, lihat
Menggunakan 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, penyelenggara 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
penyelenggara 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
Penyelenggara rapat selalu dapat memasuki rapat tanpa meminta izin masuk, tetapi kini Anda
dapat mengonfigurasi anggota yang juga dapat bergabung ke rapat tanpa 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
penyelenggara 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.
Mengelola artefak otomatis
Penyelenggara rapat, tetapi bukan rekan penyelenggara, dapat mengonfigurasi rekaman otomatis, transkrip otomatis, dan "buat catatan untuk saya" di ruang rapat. Jika setelan ini diaktifkan, ruang rapat akan otomatis direkam, transkrip akan dibuat, dan catatan rapat akan otomatis diambil dan diatur ke dalam Google Dokumen. Setiap fitur mandiri dan ditetapkan per ruang rapat. Teks rekaman hanya tersedia dalam bahasa Inggris.
Anda dapat mengonfigurasi artefak otomatis terlebih dahulu saat membuat ruang rapat atau setelah ruang rapat dibuat. Fitur ini juga memungkinkan Anda menyiapkan artefak otomatis untuk rapat
yang dibuat dari Google Kalender. Kedua metode tersebut memerlukan
cakupan OAuth meetings.space.settings. Untuk mengetahui informasi selengkapnya, lihat Cakupan OAuth
untuk setelan.
Artefak otomatis ditetapkan melalui objek
ArtifactConfig, di bawah objek
SpaceConfig, yang merupakan bagian dari resource
spaces. ArtifactConfig terdiri dari kolom recordingConfig,
transcriptionConfig, dan smartNotesConfig.
Setiap kolom dipetakan ke objek serupa seperti
RecordingConfig
,
TranscriptionConfig
, dan
SmartNotesConfig
. Setiap objek ditetapkan menggunakan enum boolean
AutoGenerationType
untuk mengaktifkan atau menonaktifkan objek konfigurasi.
Cakupan OAuth untuk setelan
Untuk menetapkan atau mengakses setelan rapat, Anda memerlukan cakupan OAuth berikut:
| Kasus penggunaan | Kode cakupan |
|---|---|
| Menetapkan pembuatan artefak otomatis untuk ruang yang dibuat oleh aplikasi lain. | https://www.googleapis.com/auth/meetings.space.settings |
| Mendapatkan atau mencantumkan artefak dari konferensi yang dibuat oleh aplikasi lain. | https://www.googleapis.com/auth/meetings.space.readonly |
| Mendapatkan atau mencantumkan setelan pra-rapat lainnya dari ruang rapat yang dibuat oleh aplikasi pihak ketiga. | https://www.googleapis.com/auth/meetings.space.createdhttps://www.googleapis.com/auth/meetings.space.readonly |
| Membaca dan mengedit setelan untuk semua ruang rapat yang dapat diakses pengguna melalui aplikasi lain, seperti Kalender. | https://www.googleapis.com/auth/meetings.space.settings |
Untuk informasi selengkapnya tentang cakupan OAuth, lihat Cakupan Meet REST API.