Ringkasan ruang rapat Google Meet

Ilustrasi Google Meet REST API

Panduan ini menjelaskan cara Google Meet REST API memungkinkan Anda membuat dan mengelola rapat untuk Google Meet.

Ruang rapat mewakili tempat virtual atau objek persisten (seperti ruang rapat) tempat konferensi diadakan. Hanya satu konferensi aktif yang dapat diadakan di satu ruang dalam satu waktu. Ruang pertemuan juga membantu pengguna bertemu dan menemukan sumber daya bersama.

Untuk menggunakan ruang rapat, lihat Membuat dan mengelola ruang rapat. Untuk mempelajari cara mengonfigurasi ruang rapat secara terprogram, lihat Mengonfigurasi ruang rapat dan anggota.

Cara memanggil metode ruang rapat

Tabel berikut menjelaskan peran rapat yang diperlukan untuk menggunakan metode ruang rapat:

Metode Pemilik Peserta Lainnya
endActiveConference x
get x x x
     dengan setelan x
     dengan konferensi aktif x x
patch x

Cara Meet mengidentifikasi ruang rapat

Google Meet REST API membuat resource spaces untuk setiap ruang rapat. Resource spaces menawarkan beberapa titik masuk untuk bergabung ke konferensi.

Tabel berikut menunjukkan cara mengidentifikasi dan bergabung ke ruang rapat:

Nama kolom Deskripsi
name Nama ruang. String {space} adalah ID resource untuk ruang dan diformat sebagai spaces/{space}. ID ini adalah ID unik yang dibuat server dan peka huruf besar/kecil. Misalnya, spaces/jQCFfuBOdN5z.
meetingCode Alias untuk nama ruang. {meetingCode} adalah string karakter unik yang dapat diketik dan tidak peka huruf besar/kecil. Formatnya adalah spaces/{meetingCode}. Misalnya, spaces/abc-mnop-xyz. Panjang maksimum adalah 128 karakter. Aturan ini merupakan bagian dari meetingUri: https://meet.google.com/abc-mnop-xyz.
phoneAccess Metode akses telepon untuk ruang rapat ini. Objek phoneAccess berisi informasi yang diperlukan untuk bergabung ke konferensi, termasuk nomor telepon regional untuk ruang rapat dan kode PIN khusus untuk nomor telepon tersebut. PIN hanya terdiri dari digit desimal dan panjangnya dapat bervariasi. Misalnya, "pin": 19707127300.

Mirip dengan UI Meet, resource spaces mencakup serangkaian nomor telepon terbatas. Anda dapat melihat nomor telepon tambahan untuk ruang pertemuan dengan menambahkan {meetingCode} ke URL berikut: https://meet.google.com/tel/. Contohnya, https://meet.google.com/tel/abc-mnop-xyz.
gatewaySipAccess Metode akses Session Initiation Protocol (SIP) untuk ruang rapat ini. Alamat SIP menjelaskan cara hardware konferensi video pihak ketiga dapat menemukan dan bergabung ke konferensi Meet. Objek gatewaySipAccess berisi URI dan kode akses numerik. Meet mendukung skema URI SIP.

Untuk mengelola ruang rapat, gunakan nilai berikut untuk kolom name:

  • Untuk mendapatkan detail tentang ruang rapat, Anda dapat menggunakan spaces/{space} atau alias spaces/{meetingCode}. Untuk mengetahui informasi selengkapnya, lihat Mendapatkan ruang rapat.

  • Untuk memperbarui detail ruang pertemuan, Anda hanya dapat menggunakan spaces/{space}. Untuk mengetahui informasi selengkapnya, lihat Memperbarui ruang pertemuan.

  • Untuk mengakhiri konferensi aktif dalam ruang rapat, Anda hanya dapat menggunakan spaces/{space}. Untuk mengetahui informasi selengkapnya, lihat Mengakhiri konferensi aktif.

Siklus proses ruang rapat

Ruang pertemuan melalui beberapa status selama siklus prosesnya. Diagram berikut menunjukkan langkah-langkah tingkat tinggi dari siklus proses ruang rapat:

Siklus proses ruang pertemuan.
Gambar 1. Siklus proses ruang rapat.

  1. Panggil spaces.create. Ruang rapat dibuat dan objek spaces yang ditampilkan berisi string meetingUri. meetingUri kemudian didistribusikan kepada peserta.

  2. Buat polling untuk ruang rapat baru. Panggil metode spaces.get untuk memeriksa status konferensi.

    Selain melakukan polling, Anda juga dapat berlangganan acara Meet untuk menerima notifikasi push.

  3. Mulai konferensi. Saat peserta pertama mengklik meetingUri di dalam ruang rapat, konferensi akan dimulai. Objek activeConference diisi dan string activeConference.conferenceRecord ditetapkan.

  4. (Opsional) Dapatkan data konferensi. Selama konferensi aktif, Anda dapat mengakses beberapa nilai conferenceRecord. Misalnya, panggil metode conferenceRecords.participants.list untuk melihat semua peserta dalam konferensi. Anda juga dapat mengakses informasi ini hingga 30 hari setelah konferensi.

  5. (Opsional) Akhiri konferensi. Selama konferensi, pemilik rapat dapat memanggil metode spaces.endActiveConference untuk mengakhiri konferensi aktif secara terprogram bagi semua peserta.

  6. Konferensi berakhir. Saat peserta terakhir keluar, konferensi akan berakhir.

  7. Polling untuk artefak pasca-konferensi. Konferensi telah berakhir (STATE=ENDED), tetapi artefak belum dibuat. startTime dan endTime untuk konferensi juga diisi. Anda harus membuat polling endpoint artefak hingga objek artefak STATE membaca FILE_GENERATED.

    Daripada melakukan polling, Anda dapat berlangganan acara Meet untuk menerima notifikasi push.

  8. Mendapatkan artefak pasca-konferensi. Anda dapat mengambil artefak seperti rekaman dan transkrip setelah dibuat. Misalnya, panggil metode conferenceRecords.recordings.get untuk mendapatkan rekaman menurut ID rekaman.

    Setelah siap, URI ke objek artefak akan diisi dan ditampilkan sebagai bagian dari objek resource.