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 kapan saja. Ruang rapat juga membantu pengguna bertemu dan menemukan resource 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 perbandingan berikut menjelaskan peran rapat yang diperlukan untuk menggunakan metode ruang rapat:

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

Cara Meet mengidentifikasi ruang rapat

Google Meet REST API menghasilkan spaces resource untuk setiap ruang rapat. Resource spaces menawarkan beberapa titik entri 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 identifier untuk ruang dan diformat sebagai spaces/{space}. ID ini unik, dibuat oleh 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 maksimumnya adalah 128 karakter. Kode 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 melakukan panggilan 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 menyertakan kumpulan terbatas nomor panggilan masuk. Anda dapat melihat nomor telepon tambahan untuk ruang rapat dengan menambahkan {meetingCode} ke URL berikut: https://meet.google.com/tel/. Misalnya, https://meet.google.com/tel/abc-mnop-xyz.
gatewaySipAccess Metode akses Protokol Pemulaian Sesi (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 rapat, Anda hanya dapat menggunakan spaces/{space}. Untuk mengetahui informasi selengkapnya, lihat Memperbarui ruang rapat.

  • 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 rapat 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. Polling ruang rapat baru. Panggil metode spaces.get untuk memeriksa status konferensi.

    Selain melakukan polling, Anda juga dapat berlangganan ke peristiwa 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 spaces.endActiveConference metode 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 melakukan polling pada endpoint artefak hingga objek artefak STATE menampilkan FILE_GENERATED.

    Selain melakukan polling, Anda dapat berlangganan ke peristiwa Meet untuk menerima notifikasi push.

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

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