Ruang rapat mewakili tempat virtual atau objek persisten (seperti ruang rapat) tempat konferensi diadakan. Ruang pertemuan juga membantu pengguna bertemu dan menemukan sumber daya bersama.
Saat Anda membuat ruang rapat menggunakan metode
spaces.create,
metode ini akan menampilkan instance resource
spaces. Resource
mencakup
objek SpaceConfig
yang merupakan konfigurasi untuk ruang rapat. Objek ini juga berisi
ActiveConference
objek yang merupakan link ke
conferenceRecords
resource saat ini dalam ruang pertemuan. Untuk mengetahui informasi selengkapnya tentang cara mengelola ruang rapat, lihat Membuat dan mengelola ruang rapat.
Bagian berikut menjelaskan secara mendetail cara mengonfigurasi ruang rapat menggunakan objek dan metode ini.
Menetapkan moderasi dan akses rapat
Anda dapat menetapkan cara pengguna bergabung ke rapat, mode moderasi, pembatasan fitur, dan izin yang diterima pengguna saat bergabung ke rapat, melalui objek SpaceConfig.
Mengakses ruang rapat
Untuk menentukan siapa yang dapat bergabung ke ruang rapat tanpa meminta izin masuk, tetapkan kolom accessType menggunakan objek
AccessType.
Anda dapat memilih dari beberapa setelan tentang apakah peserta diizinkan bergabung secara otomatis atau tidak. Secara default, kolom ini diisi dengan setelan akses default pengguna.
Untuk menentukan titik entri yang dapat digunakan untuk bergabung ke rapat yang dihosting di ruang
rapat, tetapkan kolom entryPointAccess menggunakan objek
EntryPointAccess. Setel ke ALL untuk mengizinkan semua titik entri atau CREATOR_APP_ONLY untuk mencakup
titik entri hanya pada titik entri yang dimiliki oleh project Google Cloud yang membuat
ruang rapat.
Membuat laporan kehadiran
Untuk membuat laporan kehadiran untuk ruang rapat, tetapkan kolom boolean
attendanceReportGenerationType menggunakan objek
AttendanceReportGenerationType. Jika laporan diminta, Google Meet akan menyimpan laporan kehadiran ke Google Drive penyelenggara rapat dan email juga akan dikirim.
Memoderasi ruang rapat
Untuk memoderasi rapat, Anda dapat menyetel kolom boolean moderation menggunakan objek
Moderation.
Jika mode moderation adalah on, penyelenggara rapat memiliki kontrol atas rapat dengan fitur seperti pengelolaan rekan penyelenggara (lihat spaces.members) dan pembatasan fitur menggunakan kolom moderationRestrictions. Untuk mengetahui informasi selengkapnya tentang anggota, lihat Mengelola anggota ruang.
Untuk menentukan batasan fitur saat rapat dimoderasi (moderation adalah
on), tetapkan kolom moderationRestrictions menggunakan
objek
ModerationRestrictions. Pembatasan menentukan siapa yang memiliki izin dalam ruang rapat untuk mengirim pesan atau reaksi chat, atau membagikan layar.
Untuk menetapkan batasan fitur pada kolom moderationRestrictions, gunakan enum
RestrictionType
untuk menerapkan chatRestriction, reactionRestriction,
presentRestriction. Tetapkan ke HOSTS_ONLY untuk menerapkan izin ke penyelenggara dan rekan penyelenggara rapat, atau NO_RESTRICTION untuk menerapkan izin ke semua peserta.
Untuk membatasi peran default yang ditetapkan kepada pengguna sebagai pelihat, tetapkan kolom boolean
defaultJoinAsViewerType
menggunakan enum
DefaultJoinAsViewerType. Jika defaultJoinAsViewerType adalah on, pengguna bergabung sebagai pelihat. Jika off,
pengguna bergabung sebagai kontributor. Default-nya adalah off. Jika peran eksplisit ditetapkan untuk pengguna di spaces.members, pengguna akan bergabung dengan peran tersebut.
Mengelola artefak otomatis
Penyelenggara rapat, tetapi bukan rekan penyelenggara, dapat mengonfigurasi perekaman otomatis, transkrip otomatis, dan "buat catatan untuk saya" di ruang rapat. Jika setelan ini diaktifkan, ruang rapat akan direkam, transkrip akan dibuat, dan catatan rapat akan diambil serta diatur ke dalam Google Dokumen secara otomatis. Setiap fitur bersifat independen dan ditetapkan per ruang rapat. Teks rekaman hanya tersedia dalam bahasa Inggris.
Anda dapat mengonfigurasi artefak otomatis sebelumnya saat membuat ruang
pertemuan atau setelah
ruang pertemuan dibuat. Fitur ini juga memungkinkan Anda menyiapkan artefak otomatis
untuk rapat yang dibuat dari Google Kalender. Kedua metode memerlukan cakupan OAuth meetings.space.settings. Untuk mengetahui informasi selengkapnya, lihat Cakupan OAuth untuk setelan.
Untuk menyetel artefak otomatis, gunakan objek
ArtifactConfig
di bawah objek
SpaceConfig. ArtifactConfig terdiri dari kolom recordingConfig,
transcriptionConfig, dan smartNotesConfig.
Setiap kolom dipetakan ke objek serupa seperti
RecordingConfig
,
TranscriptionConfig
, dan
SmartNotesConfig
. Untuk menyetel setiap objek, gunakan
enum boolean AutoGenerationType
untuk mengganti objek konfigurasi on atau off.
Cakupan OAuth untuk setelan
Menetapkan atau mengakses setelan rapat 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 mengetahui informasi selengkapnya tentang cakupan OAuth, lihat Cakupan Meet REST API.
Mengelola anggota ruang
Meskipun penyelenggara rapat selalu dapat bergabung ke rapat tanpa meminta izin masuk, Anda juga dapat mengonfigurasi anggota tambahan untuk 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
conferenceRecords.participants
resource untuk setiap orang.
Anda dapat mengelola anggota ruang menggunakan metode berikut:
Setiap metode mengambil 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 delete, mendukung parameter fields di
SystemParameterContext.
Jika parameter fields tidak ada, 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 dibatasi koma untuk menentukan hanya kolom tertentu dalam objek yang digunakan, sementara kolom lainnya tidak diubah.
Dengan menggunakan FieldMask, API dapat menghindari pekerjaan yang tidak perlu dan meningkatkan
performa. Masker kolom digunakan untuk metode pembuatan, pengambilan, dan pencantuman. Untuk mengetahui informasi selengkapnya tentang mask kolom, lihat Menggunakan mask kolom di Google Sheets API.