Dokumen ini menjelaskan cara mendapatkan detail tentang berbagai artefak rapat yang dihasilkan oleh konferensi menggunakan Google Meet REST API.
Artefak adalah file atau data yang dihasilkan oleh Google Meet sebagai respons terhadap konferensi. Hal ini mencakup rekaman video dan artefak lainnya, seperti transkrip.
Untuk membuat artefak, peserta harus mengonfigurasinya di Meet sebelum konferensi berakhir. Untuk mengetahui informasi selengkapnya, lihat Mengelola artefak otomatis.
Transkrip beroperasi secara independen dari rekaman dan Anda tidak perlu merekam rapat untuk membuat transkrip. Saat semua peserta keluar dari rapat, transkrip akan otomatis berhenti. Untuk mengetahui informasi selengkapnya, lihat Merekam rapat video dan Menggunakan Transkrip dengan Google Meet.
Mengambil artefak
Jika Anda adalah pemilik atau peserta ruang pertemuan, Anda dapat memanggil metode get dan list pada resource recordings, transcripts, transcripts.entries, dan smart notes untuk mengambil artefak. Untuk informasi selengkapnya, lihat bagian berikut.
Mengautentikasi dan mengotorisasi dengan kredensial pengguna memungkinkan aplikasi Meet mengakses data pengguna dan melakukan operasi atas nama pengguna yang diautentikasi. Mengautentikasi dengan delegasi tingkat domain memungkinkan Anda mengizinkan akun layanan aplikasi untuk mengakses data pengguna Anda tanpa mewajibkan tiap pengguna memberikan izin.
Retensi artefak
Setelah konferensi berakhir, Meet menyimpan rekaman dan transkrip ke Google Drive penyelenggara rapat. Secara default, artefak Meet dipertahankan sesuai dengan aturan Drive.
Entri transkrip yang disediakan oleh Meet REST API akan dihapus 30 hari setelah konferensi berakhir.
Anda juga dapat mengelola retensi artefak Meet secara terpisah menggunakan aturan retensi khusus Meet di Google Vault. Untuk mengetahui informasi selengkapnya, lihat Mempertahankan data Google Meet dengan Vault.
Rekaman
Bagian berikut menjelaskan cara mendapatkan informasi tentang rekaman dalam rekaman konferensi.
Meet memiliki akses ke ID rekaman setelah file rekaman dibuat. Ada kemungkinan pengguna menghapus file rekaman dari Google Drive, tetapi nama uniknya masih ditampilkan di Meet.
Resource
recordings
mencakup objek
DriveDestination
dan
State.
Objek DriveDestination menyimpan lokasi ekspor di Drive
tempat rekaman disimpan sebagai file MP4. Untuk mendownload rekaman atau memutarnya kembali di browser, gunakan nilai kolom exportUri objek. Jika Anda sudah memahami Google Drive API, nilai kolom
file
sesuai dengan kolom
id di resource
files. Untuk mengetahui informasi selengkapnya, lihat Mendownload dan mengekspor file.
Objek State menyimpan status sesi perekaman. Dengan demikian, Anda dapat
mengirim kueri apakah perekaman telah dimulai, apakah perekaman telah berakhir tetapi file
perekaman belum siap, atau apakah file perekaman telah dibuat dan siap didownload.
Mendapatkan detail tentang rekaman
Untuk mendapatkan detail tentang rekaman tertentu, gunakan
metode get
pada resource
recordings
dengan parameter jalur name. Jika Anda tidak mengetahui nama rekaman,
Anda dapat mencantumkan semua nama rekaman menggunakan metode list.
Metode ini menampilkan instance resource recordings.
Contoh kode berikut menunjukkan cara mengambil rekaman tertentu:
Java
Node.js
Python
Ganti nama rekaman dengan nama ID rekaman tertentu dalam rekaman konferensi.
Mencantumkan semua rekaman
Untuk mencantumkan detail tentang semua rekaman dalam rekaman konferensi, gunakan metode
list
pada resource
recordings
dengan parameter jalur parent. Formatnya adalah
conferenceRecords/{conferenceRecord}.
Metode ini menampilkan daftar rekaman konferensi, yang diurutkan berdasarkan startTime dalam urutan menaik, sebagai instance resource recordings. Untuk menyesuaikan ukuran halaman, lihat Menyesuaikan penomoran halaman .
Contoh kode berikut menunjukkan cara mencantumkan semua rekaman dalam rekaman konferensi:
Java
Node.js
Python
Ganti nilai induk dengan nama rekaman konferensi.
Transkrip
Bagian berikut menjelaskan cara mendapatkan informasi tentang transkrip konferensi dalam rekaman konferensi.
Meet memiliki akses ke ID transkrip setelah data transkrip dibuat. Ada kemungkinan pengguna menghapus file transkrip dari Drive, tetapi nama uniknya masih ditampilkan di Meet.
Resource
transcripts
mencakup objek
DocsDestination
dan
State.
Objek DocsDestination menyimpan lokasi ekspor di Drive
tempat file transkrip Google Dokumen disimpan. Untuk mengambil konten atau menjelajahi transkrip di browser, gunakan nilai kolom exportUri objek. Jika Anda sudah terbiasa dengan Google Docs API, nilai kolom
document
sesuai dengan
documentId
di resource documents.
Objek State menyimpan status sesi transkrip. Hal ini memungkinkan Anda
mengirim kueri apakah sesi transkrip telah dimulai, apakah sesi transkrip telah berakhir
tetapi file transkrip belum siap, atau apakah file transkrip telah dibuat dan
siap didownload.
Mendapatkan detail tentang transkrip
Untuk mendapatkan detail tentang transkrip tertentu, gunakan metode
get
pada resource
transcripts
dengan parameter jalur name. Jika Anda tidak mengetahui nama transkrip,
Anda dapat mencantumkan semua nama transkrip menggunakan metode list.
Metode ini menampilkan instance resource transcripts.
Contoh kode berikut menunjukkan cara mengambil transkrip tertentu:
Java
Node.js
Python
Ganti nama transkrip dengan nama ID transkrip tertentu dalam rekaman konferensi.
Mencantumkan semua transkrip
Untuk mencantumkan detail tentang semua transkrip dalam rekaman konferensi, gunakan metode
list
pada resource
transcripts
dengan parameter jalur parent. Formatnya adalah
conferenceRecords/{conferenceRecord}.
Metode ini menampilkan daftar transkrip konferensi, yang diurutkan berdasarkan startTime dalam urutan menaik, sebagai instance resource transcripts. Untuk menyesuaikan ukuran halaman, lihat Menyesuaikan penomoran halaman .
Contoh kode berikut menunjukkan cara mencantumkan semua transkrip dalam rekaman konferensi:
Java
Node.js
Python
Ganti nilai induk dengan nama rekaman konferensi.
Entri transkrip
Bagian berikut menjelaskan secara mendetail cara mendapatkan ucapan setiap peserta sebagai entri transkrip selama sesi transkrip konferensi.
Entri transkrip berisi teks yang ditranskripsikan dari suara peserta, hingga
maksimal 10.000 kata. Teks yang diucapkan languageCode (misalnya, en-US)
juga disertakan sebagai sintaksis IETF BCP 47.
Setiap entri transkrip terhubung ke nama participant dalam konferensi. Untuk
mengambil detail peserta, lihat Mendapatkan detail tentang
peserta.
Data entri transkrip tersedia selama 30 hari setelah konferensi berakhir.
Perhatikan bahwa entri transkrip yang ditampilkan oleh Meet REST API mungkin tidak cocok dengan transkripsi yang ditemukan dalam file transkrip Dokumen. Hal ini terjadi saat file transkrip diubah setelah dibuat.
Mendapatkan detail tentang entri transkrip
Untuk mendapatkan detail tentang entri transkrip tertentu, gunakan metode
get
pada resource
transcripts.entries
dengan parameter jalur name. Jika Anda tidak mengetahui nama entri transkrip, Anda dapat mencantumkan semua nama entri transkrip menggunakan metode list.
Metode ini menampilkan instance resource transcripts.entries.
Contoh kode berikut menunjukkan cara mengambil entri transkrip tertentu:
Java
Node.js
Python
Ganti nama entri transkrip dengan nama ID entri transkrip tertentu dalam transkrip.
Mencantumkan semua entri transkrip
Untuk mencantumkan detail tentang semua entri transkrip dalam transkrip, gunakan metode
list
pada resource
transcripts.entries
dengan parameter jalur parent. Formatnya adalah
conferenceRecords/{conferenceRecord}/transcripts/{transcript}.
Metode ini menampilkan daftar entri transkrip terstruktur per transkrip konferensi, yang diurutkan berdasarkan startTime dalam urutan menaik, sebagai instance resource transcripts.entries. Untuk menyesuaikan ukuran halaman, lihat Menyesuaikan penomoran halaman .
Contoh kode berikut menunjukkan cara mencantumkan semua entri transkrip dalam transkrip:
Java
Node.js
Python
Ganti nilai induk dengan nama rekaman konferensi dan nama transkrip.
Catatan cerdas
Bagian berikut menjelaskan cara mendapatkan informasi tentang catatan pintar konferensi dalam rekaman konferensi.
Meet memiliki akses ke ID catatan smart setelah data catatan smart dibuat. Ada kemungkinan pengguna menghapus file catatan smart dari Drive, tetapi nama uniknya masih ditampilkan di Meet.
Resource smartNotes mencakup objek State.
Objek ini menyimpan status sesi catatan smart. Dengan demikian, Anda dapat membuat kueri apakah sesi catatan smart telah dimulai, apakah sesi catatan smart telah berakhir tetapi file catatan smart belum siap, atau apakah file catatan smart telah dibuat dan siap didownload.
Resource smartNotes juga mencakup jenis
objek DocsDestination. Objek ini menyimpan lokasi ekspor di Drive tempat file catatan smart Google Dokumen disimpan. Untuk mengambil konten atau menjelajahi catatan smart di browser, gunakan nilai kolom exportUri objek. Jika Anda sudah memahami Google Docs API, nilai kolom
document
sesuai dengan
documentId
di resource documents.
Anda dapat mengelola catatan smart menggunakan metode get dan
list.
Mendapatkan detail tentang catatan smart
Untuk mendapatkan detail tentang file catatan smart tertentu, gunakan metode
get pada resource
smartNotes dengan
parameter jalur name. Jika Anda tidak mengetahui nama catatan smart, Anda dapat mencantumkan
semua file catatan smart menggunakan metode list.
Metode ini menampilkan instance resource smartNotes.
Mencantumkan semua catatan smart
Untuk mencantumkan detail tentang semua file catatan pintar dalam rekaman konferensi, gunakan metode
list pada resource
smartNotes dengan
parameter jalur parent. Formatnya adalah
conferenceRecords/{conferenceRecord}.
Metode ini menampilkan daftar file catatan pintar konferensi, yang diurutkan berdasarkan
startTime dalam urutan menaik, sebagai instance resource smartNotes. Untuk menyesuaikan ukuran halaman, lihat Menyesuaikan penomoran halaman .
Menyesuaikan penomoran halaman
Teruskan parameter kueri berikut untuk menyesuaikan penomoran halaman rekaman, transkrip, dan entri transkrip:
pageSize: Jumlah maksimum item yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Jika tidak ditentukan, paling banyak 10 item akan ditampilkan. Nilai maksimum adalah 100; nilai lebih dari 100 akan otomatis diubah menjadi 100.pageToken: Token halaman, yang diterima dari panggilan daftar sebelumnya. Berikan token ini untuk mengambil halaman berikutnya.