Ringkasan Google Meet REST API

Google Meet REST API memungkinkan Anda membuat dan mengelola rapat untuk Google Meet serta menawarkan titik entri kepada pengguna Anda langsung dari aplikasi Anda.

Dengan Meet REST API, Anda dapat melakukan hal berikut:

  • Buat dan konfigurasi ruang rapat untuk menghubungkan pengguna melalui video.
  • Mengonfigurasi tingkat akses ruang, setelan moderasi, dan rekaman atau transkrip otomatis.
  • Mengelola anggota ruang rapat dan menetapkan peran co-host.
  • Mengakhiri konferensi aktif secara terprogram dalam ruang rapat.
  • Mendapatkan rekaman konferensi, detail kehadiran, dan metadata sesi peserta.
  • Mengambil artefak rapat (rekaman, transkrip, dan entri transkrip).

Anda juga dapat berlangganan peristiwa Meet menggunakan Google Workspace Events API. Untuk mendapatkan notifikasi perubahan, Anda dapat berlangganan ruang rapat tertentu atau semua ruang rapat milik pengguna tertentu. Untuk informasi selengkapnya, lihat:

Kasus penggunaan

Aplikasi dapat berintegrasi dengan Meet REST API untuk melakukan tugas berikut:

  • Sebelum konferensi: Buat ruang rapat sesuai permintaan, konfigurasi awal batasan akses (terbuka, tepercaya, atau terbatas), terapkan kontrol moderasi (berbagi layar, chat, reaksi, mikrofon, dan kamera), konfigurasi perekaman otomatis atau transkripsi otomatis, dan tetapkan peran co-host kepada anggota ruang.

  • Selama konferensi: Ambil metadata konferensi aktif dan sesi peserta, kelola anggota secara dinamis, dengarkan peristiwa siklus proses real-time menggunakan Google Workspace Events API, atau akhiri konferensi aktif secara terprogram.

  • Setelah konferensi: Ambil rekaman konferensi dan log kehadiran, download rekaman dan transkrip Google Dokumen dari Google Drive, serta akses entri ucapan transkrip terperinci untuk pelatihan, kepatuhan, atau analisis AI.

Beberapa contoh hal yang mungkin ingin Anda lakukan dengan Meet REST API meliputi hal berikut:

  • Penjualan dan pengelolaan akun

    • Mengambil informasi rapat dan peserta untuk tujuan pencatatan.
    • Mengambil artefak rapat dan mempostingnya di akun.
    • Jalankan transkripsi dan rekaman melalui model AI untuk membuat analisis efektivitas penjualan dan pelatihan.

  • Pembelajaran dan pengembangan

    • Membuat dan mengonfigurasi rapat untuk pelatihan terlebih dahulu.
    • Tetapkan peran co-host kepada pelatih dan pemimpin sesi.
    • Mengambil rekaman yang memungkinkan siswa meninjau materi setelah kursus berakhir.

  • Dukungan dan konsultasi pelanggan

    • Buat ruang rapat yang aman dan terbatas langsung dari tiket help desk atau portal klien.
    • Mengonfigurasi pengelolaan host terlebih dahulu agar hanya agen dukungan yang dapat mempresentasikan atau mengelola kehadiran.
    • Aktifkan perekaman atau transkripsi otomatis untuk jaminan kualitas dan catatan kepatuhan.
    • Mengakhiri konferensi aktif secara terprogram saat janji temu atau sesi dukungan berakhir.

  • Operasi developer

    • Buat rapat untuk terhubung dengan rekan tim secara instan.
    • Izinkan pemangku kepentingan lain bergabung ke rapat yang sedang berlangsung dengan membagikan informasi rapat dan peserta secara real-time.
    • Jalankan data transkripsi melalui model AI untuk menghasilkan langkah berikutnya yang benar.
Buat dan ikuti rapat dinamis dengan rekan kerja Anda dalam ruang Chat.
Gambar 1. Buat dan ikuti rapat dinamis dengan rekan kerja Anda dalam ruang Chat.

Anda juga dapat menyertakan API Google Workspace lainnya seperti Chat API ke dalam aplikasi Anda untuk meningkatkan kolaborasi. Untuk mengetahui informasi selengkapnya, lihat Kasus penggunaan chat.

Istilah umum

Berikut adalah daftar istilah umum yang digunakan dalam API ini:

Konferensi aktif
Konferensi berkelanjutan yang berlangsung di dalam ruang rapat. Hanya satu konferensi aktif yang dapat diadakan di ruang rapat pada waktu tertentu. Setelah berakhir, rapat akan menjadi catatan konferensi historis.
Artefak
File yang dibuat oleh Meet sebagai respons terhadap konferensi, seperti recordings dan transcripts. Artefak disimpan ke Drive penyelenggara rapat. Biasanya siap diambil segera setelah konferensi berakhir.
Acara kalender
Acara di Google Kalender dengan beberapa peserta, biasanya dibuat oleh penyelenggara rapat, yang berisi info akses rapat. Meet mungkin menjadi solusi konferensi untuk acara tersebut.
Call
Sesi menggunakan Meet, atau untuk memberi tahu orang lain bahwa panggilan sedang dimulai atau sedang berlangsung dan memungkinkan mereka segera bergabung.
Rekan penyelenggara
Seseorang dalam panggilan yang telah diberi hak pengelolaan penyelenggara oleh penyelenggara, kecuali kemampuan untuk menghapus penyelenggara awal.
Konferensi
Konferensi adalah instance panggilan dalam ruang rapat. Pengguna biasanya menganggap skenario ini sebagai satu rapat.
Rekor liga
ID unik untuk setiap instance konferensi. Ruang ini dibuat secara otomatis saat konferensi dimulai. Resource conferenceRecords menggunakan format conferenceRecords/{conferenceRecord}. Misalnya, conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ.
Bergabung melalui telepon
Untuk menggunakan ponsel guna berpartisipasi dalam panggilan atau mendengarkan panggilan yang di-streaming.
Host
Orang yang membuat panggilan (penyelenggara rapat) atau orang yang mengontrol panggilan. Perhatikan bahwa penyelenggara rapat dapat mengatur rapat, tetapi tidak hadir saat rapat berlangsung. Penyelenggara juga dapat mendelegasikan hak istimewa penyelenggara kepada rekan penyelenggara.
Kode rapat

String 10 karakter yang unik dan dapat diketik untuk ruang rapat yang digunakan dalam URI rapat ruang rapat. Tidak peka huruf besar/kecil. Contohnya, abc-mnop-xyz. Panjang maksimum adalah 128 karakter.

Kode rapat tidak boleh disimpan dalam jangka panjang karena dapat terpisah dari ruang rapat dan dapat digunakan kembali untuk ruang rapat yang berbeda di masa mendatang. Umumnya, kode rapat akan berakhir 365 hari setelah penggunaan terakhir. Untuk mengetahui informasi selengkapnya, lihat Mempelajari kode rapat di Google Meet.

Nama rapat

ID unik yang dibuat server dan digunakan untuk mengidentifikasi ruang rapat. Peka huruf besar/kecil. Misalnya, jQCFfuBOdN5z. ID rapat ditampilkan di kolom name dari resource spaces. Untuk mengetahui informasi selengkapnya, lihat Cara Meet mengidentifikasi ruang rapat.

Penyelenggara rapat

Pengguna yang membuat ruang rapat. Pengguna ini juga dapat dianggap sebagai pemilik rapat. Mereka mungkin tidak hadir selama panggilan atau bukan host rapat. Hanya boleh ada satu penyelenggara rapat.

Ruang rapat

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

URI rapat

URL yang dapat diklik yang memulai atau mengarahkan pengguna ke panggilan. Setiap panggilan memiliki URL unik yang terdiri dari https://meet.google.com/ diikuti dengan kode rapat. Contoh, https://meet.google.com/abc-mnop-xyz.

Anggota

Pengguna yang ditambahkan secara eksplisit ke ruang rapat dengan peran yang ditetapkan (seperti COHOST). Tidak seperti peserta yang hanya hadir selama konferensi live, anggota dikaitkan dengan ruang rapat persisten dan mempertahankan hak istimewanya di beberapa konferensi dalam ruang tersebut.

Peserta

Seseorang bergabung ke panggilan atau menggunakan mode Pendamping, menonton sebagai penonton, atau perangkat ruang terhubung ke panggilan. Ada satu participants resource untuk setiap orang. Saat peserta bergabung ke konferensi, ID unik akan ditetapkan.

Sesi peserta

ID sesi unik yang dibuat untuk setiap pasangan perangkat peserta yang bergabung dalam panggilan. Ada satu resource participantSessions untuk setiap sesi. Jika peserta bergabung ke panggilan yang sama beberapa kali dari pasangan perangkat-peserta yang sama, setiap kali mereka bergabung, mereka akan diberi ID sesi yang unik.

Perekaman

File video MP4 dan metadata terkait yang dibuat saat konferensi direkam. Rekaman disimpan ke Drive penyelenggara rapat dan dapat diambil sebagai artefak rapat.

Alamat SIP

Detail alamat Session Initiation Protocol (SIP) menjelaskan cara hardware konferensi video pihak ketiga dapat menemukan dan bergabung ke konferensi Meet. Meet mendukung skema URI SIP.

Transkrip

Dokumen teks yang merekam percakapan lisan dari konferensi, diekspor ke Drive penyelenggara rapat sebagai file Dokumen.

Entri transkrip

Segmen ucapan yang ditranskripsikan secara terpisah dari peserta dalam konferensi. Setiap entri mencakup identitas peserta, stempel waktu, teks yang diucapkan, dan kode bahasa, serta tersedia selama 30 hari setelah konferensi berakhir.