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 Anda.

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.
  • Dapatkan daftar peserta dan sesi peserta.
  • Dapatkan artefak rapat (rekaman, transkrip, dan entri transkrip).

Anda juga dapat berlangganan acara Meet menggunakan Google Workspace Events API. Untuk menerima notifikasi tentang perubahan, Anda dapat berlangganan ke ruang rapat yang ditentukan atau ke semua ruang rapat milik pengguna tertentu. Untuk 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.

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

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

Beberapa contoh hal yang mungkin ingin Anda gunakan dengan Meet REST API mencakup hal berikut:

  • Penjualan dan pengelolaan akun

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

  • Pembelajaran dan pengembangan

    • Membuat dan melakukan pra-konfigurasi rapat untuk pelatihan.
    • Tetapkan peran rekan penyelenggara kepada pelatih dan pemimpin sesi.
    • Ambil rekaman agar siswa dapat meninjau materi setelah kursus berakhir.

  • Operasi developer

    • Buat rapat untuk menghubungkan rekan satu tim secara langsung.
    • Biarkan pemangku kepentingan lain bergabung ke rapat yang sedang berlangsung dengan berbagi rapat {i>real-time<i} dan informasi peserta.
    • Jalankan data transkripsi melalui model AI untuk menghasilkan langkah berikutnya yang benar.
Buat dan bergabung ke rapat dinamis dengan rekan kerja dalam ruang Chat.
Gambar 1. Buat dan bergabung ke rapat dinamis dengan rekan kerja dalam ruang Chat.

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

Istilah umum

Berikut adalah daftar istilah umum yang digunakan dalam API ini:

Artefak
File yang dihasilkan 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, yang biasanya dibuat oleh penyelenggara rapat, yang berisi info akses rapat. Meet dapat menjadi solusi konferensi untuk acara.
Telepon
Sesi yang menggunakan Meet, atau untuk 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
Orang dalam panggilan yang telah diberi hak istimewa pengelolaan host oleh host, kecuali kemampuan untuk menghapus host asli.
Penyelenggara
Orang yang membuat panggilan (penyelenggara rapat) atau orang yang mengontrol panggilan. Perlu diketahui bahwa penyelenggara rapat dapat mengatur rapat, tetapi tidak dapat hadir saat rapat berlangsung. Penyelenggara juga dapat mendelegasikan hak istimewa host kepada rekan penyelenggara.
Kode rapat

String 10 karakter unik yang dapat diketik untuk ruang rapat yang digunakan dalam URI rapat di 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. Biasanya, masa berlaku kode rapat berakhir 365 hari setelah penggunaan terakhir. Untuk mengetahui informasi selengkapnya, lihat Mempelajari kode rapat di Google Meet.

Nama rapat

ID unik yang dibuat server yang digunakan untuk mengidentifikasi ruang rapat. ID ini peka huruf besar/kecil. Misalnya, jQCFfuBOdN5z. ID rapat ditampilkan di kolom name dari resource spaces.

Penyelenggara rapat

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

Ruang rapat

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

URI rapat

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

Peserta

Seseorang bergabung ke panggilan atau yang menggunakan mode Pendamping, menonton sebagai penampil, atau perangkat ruang yang terhubung ke panggilan. Ada satu referensi 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 dengan panggilan. Ada satu referensi conferenceRecords.participants.participantSessions untuk setiap sesi. Jika peserta bergabung ke panggilan yang sama beberapa kali dari pasangan perangkat peserta yang sama, mereka akan diberi ID sesi unik.

Informasi autentikasi dan otorisasi spesifik per API

Cakupan otorisasi adalah izin yang Anda minta untuk otorisasi pengguna bagi aplikasi Anda untuk mengakses konten rapat. Saat seseorang menginstal aplikasi Anda, pengguna akan diminta untuk memvalidasi cakupan tersebut. Umumnya, Anda harus memilih cakupan yang paling sempit dan menghindari permintaan cakupan yang tidak diperlukan aplikasi Anda. Pengguna lebih mudah memberikan akses ke cakupan terbatas yang dijelaskan dengan jelas.

Meet REST API mendukung cakupan OAuth 2.0 berikut:

Kode cakupan Deskripsi Penggunaan
https://www.googleapis.com/auth/meetings.space.readonly Mengizinkan aplikasi membaca metadata tentang ruang rapat apa pun yang dapat diakses pengguna. Sensitif
https://www.googleapis.com/auth/meetings.space.created Mengizinkan 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.