本指南說明如何使用 Google Meet REST API,取得會議產生的不同會議記錄詳細資料。
成果是指 Google Meet 在回應會議時產生的檔案或資料。包括影片和其他輔助資料,例如轉錄稿。
如要產生構件,參與者必須在會議結束前透過 Meet 產生構件。轉錄稿與錄音內容無關,您不必錄製會議內容就能產生轉錄稿。詳情請參閱「錄製視訊會議內容」和「在 Google Meet 中使用轉錄稿」。
如果您是會議空間擁有者或參與者,可以呼叫 recordings
、transcripts
和 transcripts.entries
資源上的 get()
和 list()
方法,擷取構件。
使用使用者憑證驗證及授權,可讓 Google Meet 應用程式存取使用者資料,並代表已驗證的使用者執行作業。您可以使用全網域委派功能進行驗證,授權應用程式的服務帳戶存取使用者資料,無須逐一取得使用者的同意。
構件保留時間
會議結束後,Meet 會將錄製內容和轉錄稿儲存到會議發起人的 Google 雲端硬碟。根據預設,系統會根據雲端硬碟規則保留 Meet 構件。
會議結束後 30 天,Meet REST API 提供的轉錄稿項目就會刪除。
您也可以使用 Google 保管箱中的 Meet 專屬保留規則,分別管理 Meet 構件的保留作業。詳情請參閱「透過保管箱保留 Google Meet 資料」。
錄音檔
以下各節將詳細說明如何取得會議記錄中的錄音資訊。
錄製檔案產生後,Meet 就能存取錄製 ID。使用者可能會從 Google 雲端硬碟中刪除錄製檔案,但 Meet 仍會傳回專屬名稱。
recordings
資源包含 DriveDestination
和 State
物件。
DriveDestination
物件會保留在雲端硬碟中的匯出位置,也就是錄音檔儲存為 MP4 檔案的位置。如要下載錄音檔或在瀏覽器中播放,請使用物件的 exportUri
欄位值。如果您熟悉 Google 雲端硬碟 API,file
欄位值會對應至 files
資源中的 id
。詳情請參閱「下載及匯出檔案」。
State
物件會保留錄音工作階段的狀態。這可讓您查詢錄製是否已開始、錄製是否已結束但錄製檔案尚未準備就緒,或是錄製檔案是否已產生並可供下載。
取得錄音檔的詳細資料
如要取得特定錄音的詳細資料,請在 recordings
資源上使用 get()
方法,並搭配 name
路徑參數。如果您不知道錄音名稱,可以使用 list()
方法列出所有錄音名稱。
這個方法會傳回 recordings
資源的例項。
以下程式碼範例說明如何擷取特定錄音:
Java
Node.js
Python
將會議記錄中的錄音名稱替換為特定錄音 ID 的名稱。
列出所有錄音
如要列出會議記錄中所有錄音的詳細資料,請在 recordings
資源上使用 parent
路徑參數的 list()
方法。格式:conferenceRecords/{conferenceRecord}
。
這個方法會傳回會議錄音清單,並以 startTime
的遞增順序排序,做為 recordings
資源的例項。如要調整頁面大小,請參閱「自訂分頁 」一節。
以下程式碼範例說明如何列出會議記錄中的所有錄音:
Java
Node.js
Python
將父項值替換為會議記錄的名稱。
轉錄稿
以下各節將詳細說明如何取得會議記錄中的會議記錄資訊。
轉錄資料產生後,Meet 就會取得轉錄 ID。使用者可能會從雲端硬碟刪除轉錄檔案,但 Meet 仍會傳回不重複的名稱。
transcripts
資源包含 DocsDestination
和 State
物件。
DocsDestination
物件會保留 Google 雲端硬碟中的匯出位置,也就是 Google 文件轉錄稿檔案的儲存位置。如要擷取內容或在瀏覽器中瀏覽轉錄稿,請使用物件的 exportUri
欄位值。如果您熟悉 Google Docs API,document
欄位值會對應至 documents
資源中的 documentId
。
State
物件會保留轉錄工作階段的狀態。這可讓您查詢字幕工作階段是否已開始、字幕工作階段是否已結束但字幕檔案尚未準備就緒,或是字幕檔案是否已產生並可供下載。
取得轉錄稿詳細資料
如要取得特定轉錄稿的詳細資料,請在 transcripts
資源上使用 get()
方法,並搭配 name
路徑參數。如果不知道逐字稿名稱,可以使用 list()
方法列出所有逐字稿名稱。
這個方法會傳回 transcripts
資源的例項。
以下程式碼範例說明如何擷取特定轉錄稿:
Java
Node.js
Python
將會議記錄中的逐字稿名稱,替換為特定逐字稿 ID 的名稱。
列出所有轉錄稿
如要列出會議記錄中所有轉錄稿的詳細資料,請在 transcripts
資源上使用 parent
路徑參數的 list()
方法。格式:conferenceRecords/{conferenceRecord}
。
這個方法會傳回會議記錄清單,並以 startTime
的遞增順序排序,做為 transcripts
資源的例項。如要調整頁面大小,請參閱「自訂分頁 」一節。
以下程式碼範例說明如何列出會議記錄中的所有轉錄稿:
Java
Node.js
Python
將父項值替換為會議記錄的名稱。
轉錄稿項目
以下各節將詳細說明如何在會議逐字稿工作階段中,將每位參與者的發言內容做為逐字稿項目。
轉錄稿項目包含參與者語音的轉錄文字,最多可達 10,000 個字。語音文字 languageCode
(例如 en-US
) 也包含在 IETF BCP 47 語法中。
每個轉錄稿項目都會連結至會議中的 participant
名稱。如要擷取參與者詳細資料,請參閱「取得參與者詳細資料」。
會議結束後,系統會保留 30 天的轉錄資料。
請注意,Meet REST API 傳回的轉錄稿項目可能與 Google 文件轉錄稿檔案中的轉錄內容不符。這是在轉錄檔產生後修改時發生的情況。
取得轉錄稿項目的詳細資料
如要取得特定逐字稿項目的詳細資料,請在 transcripts.entries
資源上使用 get()
方法,並搭配 name
路徑參數。如果不知道逐字稿項目名稱,您可以使用 list()
方法列出所有逐字稿名稱。
這個方法會傳回 transcripts.entries
資源的例項。
以下程式碼範例說明如何擷取特定轉錄內容項目:
Java
Node.js
Python
將轉錄稿項目名稱替換為轉錄稿中特定轉錄稿項目 ID 的名稱。
列出所有轉錄稿項目
如要列出逐字稿中所有逐字稿項目的詳細資料,請在 transcripts.entries
資源上使用 parent
路徑參數的 list()
方法。格式:conferenceRecords/{conferenceRecord}/transcripts/{transcript}
。
這個方法會傳回每個會議記錄的結構化逐字稿項目清單,並以 startTime
的遞增順序排序,做為 transcripts.entries
資源的例項。如要調整頁面大小,請參閱「自訂分頁 」一文。
以下程式碼範例說明如何列出轉錄稿中的所有轉錄項目:
Java
Node.js
Python
將父項值替換為會議記錄和轉錄稿名稱。
自訂分頁
傳遞下列查詢參數,即可自訂錄音、逐字稿和逐字稿項目的分頁:
pageSize
:可退回的項目數量上限。服務傳回的產品數量可能會少於這個值。如未指定,最多會傳回 10 個項目。許可的最大值為 100;超過 100 的值會自動變更為 100。pageToken
:從先前 list 呼叫收到的頁面權杖。提供這個符記即可擷取後續網頁。