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 harus 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.
Mengautentikasi dan memberikan otorisasi dengan kredensial pengguna memungkinkan aplikasi Google 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 id
di resource files
. Untuk
mengetahui informasi selengkapnya, lihat
Mendownload dan mengekspor file.
Objek State
menyimpan status sesi perekaman. Hal ini memungkinkan Anda
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
. Format:
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 memahami 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
. Format:
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
maksimum 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 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
. 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 rekaman 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, paling banyak 10 item akan ditampilkan. Nilai maksimum adalah 100; nilai 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