本指南說明如何使用 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 Drive API,file
欄位值會對應至 files
資源中的 id
。詳情請參閱下載及匯出檔案。
State
物件會保留錄音工作階段的狀態。您可以查詢錄製作業是否已開始、是否已結束但錄製檔案尚未準備就緒,或是錄製檔案是否已產生並可供下載。
查看錄製內容的詳細資料
如要取得特定錄製內容的詳細資料,請在 recordings
資源上使用 get()
方法,並搭配 name
路徑參數。如果您不知道錄音名稱,可以使用 list()
方法列出所有錄音名稱。
這個方法會傳回 recordings
資源的執行個體。
下列程式碼範例說明如何擷取特定錄製內容:
Java
Node.js
Python
將錄音名稱替換為會議記錄中的特定錄音 ID 名稱。
列出所有錄音
如要列出會議記錄中所有錄音的詳細資料,請使用 recordings
資源的 list()
方法,並搭配 parent
路徑參數。格式:
conferenceRecords/{conferenceRecord}
。
這個方法會傳回會議錄影清單,並以遞增順序依 startTime
排序,做為 recordings
資源的執行個體。如要調整頁面大小,請參閱自訂分頁 。
下列程式碼範例說明如何列出會議記錄中的所有錄音:
Java
Node.js
Python
將父項值替換為會議記錄名稱。
轉錄稿
以下各節將詳細說明如何取得會議記錄中會議轉錄稿的相關資訊。
轉錄稿資料生成後,Meet 就能存取轉錄稿 ID。使用者可能會從雲端硬碟刪除轉錄稿檔案,但 Meet 仍會傳回專屬名稱。
transcripts
資源包含 DocsDestination
和 State
物件。
DocsDestination
物件會保留 Google 雲端硬碟中的匯出位置,Google 文件轉錄稿檔案會儲存在該位置。如要擷取內容或在瀏覽器中瀏覽轉錄稿,請使用物件的 exportUri
欄位值。如果您熟悉 Google 文件 API,document
欄位值會對應至 documents
資源中的 documentId
。
State
物件會保留轉錄工作階段的狀態。您可以查詢轉錄工作階段是否已開始、轉錄工作階段是否已結束但轉錄稿檔案尚未準備就緒,或是轉錄稿檔案是否已生成並可供下載。
取得轉錄稿的詳細資料
如要取得特定轉錄稿的詳細資料,請使用 transcripts
資源的 get()
方法,並提供 name
路徑參數。如果您不知道轉錄稿名稱,可以使用 list()
方法列出所有轉錄稿名稱。
這個方法會傳回 transcripts
資源的執行個體。
下列程式碼範例說明如何擷取特定轉錄稿:
Java
Node.js
Python
將轉錄稿名稱替換為會議記錄中的特定轉錄稿 ID 名稱。
列出所有轉錄稿
如要列出會議記錄中所有轉錄稿的詳細資料,請使用 transcripts
資源的 list()
方法,並搭配 parent
路徑參數。格式:
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 的名稱。
列出所有轉錄稿項目
如要列出轉錄稿中所有轉錄稿項目的詳細資料,請使用 parent
路徑參數,對 transcripts.entries
資源執行 list()
方法。格式:
conferenceRecords/{conferenceRecord}/transcripts/{transcript}
。
這個方法會傳回每個會議記錄的結構化轉錄稿項目清單,並以遞增順序依 startTime
排序,做為 transcripts.entries
資源的執行個體。如要調整頁面大小,請參閱自訂分頁 。
下列程式碼範例說明如何列出轉錄稿中的所有轉錄稿項目:
Java
Node.js
Python
將父項值替換為會議記錄名稱和轉錄稿名稱。
自訂分頁
傳遞下列查詢參數,自訂錄音、轉錄稿和轉錄稿項目的分頁:
pageSize
:可退貨的商品數量上限。服務傳回的產品數量可能會少於這個值。如未指定,最多將傳回 10 個項目。最大值為 100,超過 100 的值會自動變更為 100。pageToken
:屬於接收自前一個清單呼叫的網頁權杖。提供此權杖即可擷取後續網頁。