Panduan 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 video dan artefak lainnya, seperti transkrip.
Untuk membuat artefak, peserta harus membuatnya di Meet sebelum konferensi berakhir. Transkrip beroperasi secara independen dari rekaman dan Anda tidak perlu merekam rapat untuk membuat transkrip. Untuk mengetahui informasi selengkapnya, lihat Merekam rapat video dan Menggunakan Transkrip dengan Google Meet.
Jika Anda adalah pemilik atau peserta ruang rapat, Anda dapat memanggil metode get()
dan
list()
pada resource recordings
, transcripts
, dan
transcripts.entries
untuk mengambil artefak.
Dengan mengautentikasi dan memberikan otorisasi menggunakan kredensial pengguna, aplikasi Google Meet dapat mengakses data pengguna dan melakukan operasi atas nama pengguna yang diautentikasi. Dengan melakukan autentikasi menggunakan delegasi tingkat domain, Anda dapat memberikan otorisasi kepada akun layanan aplikasi untuk mengakses data pengguna tanpa mewajibkan setiap pengguna memberikan izin.
Retensi artefak
Setelah konferensi berakhir, Meet akan 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 data konferensi.
Meet memiliki akses ke ID rekaman setelah file rekaman dibuat. Mungkin pengguna menghapus file rekaman dari Google Drive, tetapi nama unik 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 di browser, gunakan nilai kolom exportUri
objek. Jika Anda
sudah memahami Google Drive API, nilai kolom file
akan sesuai dengan id
di resource files
. Untuk mengetahui informasi
selengkapnya, lihat Mendownload dan mengekspor
file.
Objek State
menyimpan status sesi perekaman. Hal ini memungkinkan Anda
mengajukan kueri apakah rekaman telah dimulai, apakah rekaman telah berakhir, tetapi file
rekaman belum siap, atau apakah file rekaman 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 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 data konferensi.
Mencantumkan semua rekaman
Untuk mencantumkan detail tentang semua rekaman dalam data konferensi, gunakan metode list()
pada resource recordings
dengan parameter jalur parent
. Format:
conferenceRecords/{conferenceRecord}
.
Metode ini menampilkan daftar rekaman konferensi, yang diurutkan menurut 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 data konferensi.
Transkrip
Bagian berikut menjelaskan cara mendapatkan informasi tentang transkrip konferensi dalam data konferensi.
Meet memiliki akses ke ID transkrip setelah data transkrip dibuat. Mungkin pengguna menghapus file transkrip dari Drive, tetapi nama unik 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
membuka transkrip di browser, gunakan nilai kolom exportUri
objek. Jika
Anda sudah terbiasa dengan Google Docs API, nilai kolom document
sesuai dengan
documentId
dalam resource
documents
.
Objek State
menyimpan status sesi transkrip. Hal ini memungkinkan Anda
mengajukan 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()
di resource transcripts
dengan parameter jalur name
. Jika 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 transkripsi tertentu:
Java
Node.js
Python
Ganti nama transkrip dengan nama ID transkrip tertentu dalam data konferensi.
Mencantumkan semua transkrip
Untuk mencantumkan detail tentang semua transkrip dalam rekaman konferensi, gunakan metode list()
di resource transcripts
dengan parameter jalur parent
. Format:
conferenceRecords/{conferenceRecord}
.
Metode ini menampilkan daftar transkrip konferensi, yang diurutkan menurut 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 data konferensi.
Entri transkrip
Bagian berikut menjelaskan cara mendapatkan ucapan setiap peserta sebagai entri transkrip selama sesi transkrip konferensi.
Entri transkrip berisi teks yang ditranskripsikan dari suara peserta, hingga
maksimum 10.000 kata. Teks lisan 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 transkrip yang ditemukan dalam file transkrip Dokumen. Hal ini terjadi saat file transkrip diubah setelah pembuatan.
Mendapatkan detail tentang entri transkrip
Untuk mendapatkan detail tentang entri transkrip tertentu, gunakan metode
get()
di resource
transcripts.entries
dengan parameter jalur name
. Jika tidak mengetahui nama entri
transkrip, Anda dapat mencantumkan semua nama 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()
di resource transcripts.entries
dengan parameter jalur parent
. Format:
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 data konferensi dan nama transkrip.
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, maksimal 10 item akan ditampilkan. Nilai maksimumnya adalah 100; nilai yang lebih dari 100 akan otomatis diubah menjadi 100.pageToken
: Token halaman, diterima dari panggilan daftar sebelumnya. Berikan token ini untuk mengambil halaman berikutnya.
Topik terkait
- Merekam rapat video
- Menggunakan Transkrip dengan Google Meet
- Mempertahankan data Google Meet dengan Vault
- Menyesuaikan fitur Meet sebagai admin