Ruang rapat mewakili tempat virtual atau objek persisten (seperti ruang rapat) tempat konferensi diadakan. Ruang pertemuan 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
menyertakan
objek SpaceConfig
yang merupakan konfigurasi untuk ruang rapat. Objek 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 Membuat dan mengelola ruang rapat.
Bagian berikut menjelaskan cara mengonfigurasi ruang rapat menggunakan objek dan metode ini.
Menetapkan moderasi dan akses rapat
Anda dapat menetapkan cara pengguna bergabung ke rapat, mode moderasi, batasan 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 perlu meminta izin masuk, tetapkan kolom accessType
menggunakan
objek AccessType.
Anda dapat memilih dari beberapa setelan tentang apakah akan mengizinkan
peserta bergabung secara otomatis. Kolom ini ditetapkan secara default ke setelan akses default pengguna.
Untuk menentukan titik entri yang dapat digunakan untuk bergabung ke rapat yang diselenggarakan di ruang rapat, tetapkan kolom entryPointAccess menggunakan objek EntryPointAccess. Tetapkan ke ALL untuk mengizinkan semua titik entri atau CREATOR_APP_ONLY untuk cakupan
titik entri hanya ke titik yang dimiliki oleh project Google Cloud yang membuat
ruang rapat.
Membuat laporan kehadiran
Untuk membuat laporan kehadiran ruang rapat, tetapkan kolom attendanceReportGenerationType Boolean 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 menetapkan kolom moderation boolean 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. Batasan ini menentukan siapa yang memiliki izin dalam ruang rapat untuk
mengirim pesan atau reaksi chat, atau membagikan layarnya.
Untuk menetapkan batasan fitur pada kolom moderationRestrictions, gunakan enum
RestrictionType
untuk menerapkan chatRestriction, reactionRestriction,
presentRestriction. Tetapkan ke HOSTS_ONLY untuk menerapkan izin ke
penyelenggara rapat dan rekan penyelenggara, atau NO_RESTRICTION untuk diterapkan 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 akan 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 sebagai peran tersebut.
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 direkam, transkrip akan dibuat, dan catatan rapat akan diambil dan 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 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.
Untuk menetapkan artefak otomatis, gunakan objek
ArtifactConfig, di bagian objek
SpaceConfig. ArtifactConfig terdiri dari kolom recordingConfig,
transcriptionConfig, dan smartNotesConfig.
Setiap kolom dipetakan ke objek serupa seperti
RecordingConfig
,
TranscriptionConfig
, dan
SmartNotesConfig
. Untuk menetapkan setiap objek, gunakan enum boolean
AutoGenerationType
untuk mengalihkan objek konfigurasi on atau off.
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.
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
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.