Ringkasan Google Meet REST API

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

Dengan Meet REST API, Anda dapat melakukan hal berikut:

  • Buat ruang rapat untuk menghubungkan pengguna melalui video.
  • Dapatkan ruang rapat atau konferensi berdasarkan nama fasilitas.
  • Mendapatkan daftar peserta dan sesi peserta.
  • Mendapatkan artefak rapat (rekaman, transkrip, dan entri transkrip).

Anda juga dapat berlangganan acara Meet menggunakan Google Workspace Events API. Untuk mendapatkan notifikasi tentang perubahan, Anda dapat berlangganan ke ruang rapat yang ditentukan atau ke semua ruang rapat milik pengguna tertentu. Untuk mengetahui informasi selengkapnya, lihat Berlangganan acara menggunakan Google Workspace Events API dan Berlangganan acara Google Meet.

Kasus penggunaan

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

  • Sebelum konferensi: Sesuaikan pengalaman konferensi sesuai kebutuhan dengan membuat ruang rapat. Anda juga dapat mengelola tamu undangan dan mengonfigurasi setelan terlebih dahulu.

  • Selama konferensi: Ambil informasi konferensi untuk mengubah pengalaman aplikasi Anda berdasarkan metadata yang ditampilkan.

  • Setelah konferensi: Mengambil artefak konferensi, seperti rekaman dan transkripsi.

Beberapa contoh hal-hal yang mungkin ingin Anda gunakan dengan REST API Meet meliputi:

  • Penjualan dan pengelolaan akun

    • Mengambil informasi rapat dan peserta untuk tujuan perekaman.
    • Ambil artefak rapat dan posting di akun.
    • Jalankan transkripsi dan rekaman melalui model AI untuk menghasilkan analisis pelatihan dan efektivitas penjualan.

  • Pembelajaran dan pengembangan

    • Membuat dan mengonfigurasi rapat untuk pelatihan terlebih dahulu.
    • Tetapkan peran rekan penyelenggara untuk pelatih dan pemimpin sesi.
    • Ambil rekaman yang memungkinkan siswa meninjau materi setelah kursus berakhir.

  • Operasi developer

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

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

Istilah umum

Berikut adalah daftar istilah umum yang digunakan dalam API ini:

Artefak
File yang dibuat oleh Meet sebagai respons terhadap konferensi, seperti rekaman dan transcripts. Biasanya artefak siap diambil segera setelah konferensi berakhir.
Acara kalender
Acara di Google Kalender dengan beberapa tamu, biasanya dibuat oleh penyelenggara rapat, yang berisi info akses rapat. Meet dapat menjadi solusi konferensi untuk acara tersebut.
Telepon
Sesi menggunakan Meet, atau memberi tahu orang lain bahwa panggilan akan dimulai atau sedang berlangsung, dan memungkinkan mereka untuk segera bergabung.
Konferensi
Konferensi adalah instance panggilan dalam ruang rapat. Pengguna biasanya menganggap skenario ini sebagai satu rapat.
Rekan penyelenggara
Seseorang dalam panggilan yang telah diberi hak istimewa pengelolaan host oleh host, kecuali kemampuan untuk menghapus host asli.
Pembawa acara
Orang yang membuat panggilan (penyelenggara rapat) atau orang yang mengontrol panggilan. Perhatikan bahwa penyelenggara rapat dapat menyelenggarakan rapat, tetapi tidak akan hadir saat rapat berlangsung. Penyelenggara juga dapat mendelegasikan hak istimewa host kepada rekan penyelenggara.
Kode rapat
String 10 karakter yang dapat diketik dan unik untuk ruang rapat yang digunakan dalam URL gabungan ruang rapat. Misalnya, abc-mnop-xyz. Kode rapat tidak boleh disimpan dalam jangka panjang karena dapat terpisah dari ruang rapat dan dapat digunakan kembali untuk ruang rapat yang berbeda pada masa mendatang. Biasanya, masa berlaku kode rapat akan berakhir 365 hari setelah penggunaan terakhir. Untuk mengetahui informasi selengkapnya, lihat Mempelajari kode rapat di Google Meet.
Nama rapat
ID unik buatan server yang digunakan untuk mengidentifikasi ruang rapat. ID rapat ditampilkan di kolom name dari resource spaces.
Penyelenggara rapat
Pengguna yang membuat ruang rapat. Pengguna ini juga dapat dianggap sebagai pemilik rapat. Orang tersebut mungkin tidak ada selama panggilan atau merupakan host rapat. Hanya boleh ada satu penyelenggara rapat.
Ruang rapat
Tempat virtual atau objek tetap (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 materi yang dibagikan.
Peserta
Seseorang bergabung ke panggilan atau yang menggunakan mode Pendamping, menonton sebagai penonton, atau perangkat ruang yang terhubung ke panggilan. Ada satu resource conferenceRecords.participants 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 ke panggilan. Ada satu resource conferenceRecords.participants.participantSessions untuk setiap sesi. Jika peserta bergabung ke panggilan yang sama beberapa kali dari pasangan peserta-perangkat yang sama, mereka masing-masing diberi ID sesi unik.

Informasi otorisasi dan autentikasi khusus API

Cakupan otorisasi adalah izin yang Anda minta untuk diberikan otorisasi kepada pengguna agar aplikasi Anda dapat mengakses konten rapat. Saat seseorang menginstal aplikasi Anda, pengguna akan diminta untuk memvalidasi cakupan ini. Umumnya, Anda harus memilih cakupan yang paling terfokus dan menghindari permintaan cakupan yang tidak diperlukan aplikasi Anda. Pengguna dapat lebih mudah memberikan akses ke cakupan yang terbatas dan dideskripsikan dengan jelas.

REST API Meet mendukung cakupan OAuth 2.0 berikut:

Kode cakupan Deskripsi Penggunaan
https://www.googleapis.com/auth/meetings.space.readonly Izinkan aplikasi membaca metadata tentang ruang rapat apa pun yang dapat diakses pengguna. Sensitif
https://www.googleapis.com/auth/meetings.space.created Izinkan aplikasi membuat, mengubah, dan membaca metadata tentang ruang rapat yang dibuat oleh aplikasi Anda. Sensitif
https://www.googleapis.com/auth/drive.readonly Izinkan aplikasi mendownload file rekaman dan transkrip dari Google Drive API. Dibatasi

Untuk informasi selengkapnya tentang cakupan OAuth 2.0 tertentu, lihat Cakupan OAuth 2.0 untuk Google API.