本文說明如何使用 Google Meet REST API,取得會議產生的各種會議構件詳細資料。
構件是指 Google Meet 因應會議而產生的檔案或資料。包括錄製的影片和其他構件,例如轉錄稿。
如要產生會議成果,參與者必須在會議結束前,在 Meet 中設定相關選項。詳情請參閱「管理自動構件」。
轉錄稿與錄音檔各自獨立,不必錄製會議即可產生轉錄稿。所有參與者都離開會議後,系統便會自動停止轉錄。詳情請參閱「錄製視訊會議內容」和「使用 Google Meet 轉錄稿」。
擷取構件
如果您是會議空間擁有者或參與者,可以呼叫 recordings、transcripts、transcripts.entries 和 smart notes 資源的 get 和 list 方法,擷取構件。詳情請參閱下列各節。
使用使用者憑證進行驗證和授權,可讓 Meet 應用程式存取使用者資料,並代表通過驗證的使用者執行作業。使用全網域委派進行驗證,可授權應用程式的服務帳戶存取使用者資料,不必逐一取得使用者的同意。
構件保留
會議結束後,Meet 會將錄製內容和轉錄稿儲存到會議發起人的 Google 雲端硬碟。根據預設,系統會根據雲端硬碟規則保留 Meet 構件。
會議結束後 30 天,系統就會刪除 Meet REST API 提供的轉錄稿項目。
您也可以在 Google 保管箱中,使用 Meet 專屬的資料保留規則,分別管理 Meet 構件的保留作業。詳情請參閱「透過 Google 保管箱保留 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 名稱。
列出所有轉錄稿
如要列出會議記錄中所有轉錄稿的詳細資料,請使用 parent 路徑參數,對 transcripts 資源執行 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 資源的 list 方法,並提供 parent 路徑參數。格式為 conferenceRecords/{conferenceRecord}/transcripts/{transcript}。
這個方法會傳回每個會議記錄的結構化轉錄稿項目清單,並以遞增順序依 startTime 排序,做為 transcripts.entries 資源的執行個體。如要調整頁面大小,請參閱自訂分頁 。
下列程式碼範例說明如何列出轉錄稿中的所有轉錄稿項目:
Java
Node.js
Python
將父項值替換為會議記錄名稱和轉錄稿名稱。
智慧紀錄
以下各節將詳細說明如何取得會議記錄中會議智慧筆記的相關資訊。
智慧筆記資料生成後,Meet 就能存取智慧筆記 ID。使用者可能會從雲端硬碟刪除智慧筆記檔案,但 Meet 仍會傳回該檔案的專屬名稱。
smartNotes 資源包含 State 物件。這個物件會保留智慧筆記工作階段的狀態。您可以查詢智慧筆記工作階段是否已開始、智慧筆記工作階段是否已結束但智慧筆記檔案尚未準備就緒,或是智慧筆記檔案是否已生成並可供下載。
smartNotes 資源也包含 DocsDestination 物件類型。這個物件會保留 Google 雲端硬碟中的匯出位置,Google 文件智慧附註檔案會儲存在該位置。如要擷取內容或在瀏覽器中瀏覽智慧筆記,請使用物件的 exportUri 欄位值。如果您熟悉 Google 文件 API,document 欄位值會對應至 documents 資源中的 documentId。
取得智慧附註的詳細資料
如要取得特定智慧筆記檔案的詳細資料,請對 smartNotes 資源使用 get 方法,並提供 name 路徑參數。如果您不知道智慧筆記的名稱,可以使用 list 方法列出所有智慧筆記檔案。
這個方法會傳回 smartNotes 資源的執行個體。
列出所有智慧筆記
如要列出會議記錄中所有智慧筆記檔案的詳細資料,請使用 smartNotes 資源的 list 方法,並提供 parent 路徑參數。格式為 conferenceRecords/{conferenceRecord}。
這個方法會傳回會議智慧筆記檔案清單,並依 startTime 遞增排序,做為 smartNotes 資源的執行個體。如要調整頁面大小,請參閱「自訂分頁 」。
自訂分頁
傳遞下列查詢參數,自訂錄音、轉錄稿和轉錄稿項目的分頁:
pageSize:要傳回的項目數量上限。服務傳回的產品數量可能會少於這個值。如未指定,最多將傳回 10 個項目。最大值為 100,超過 100 的值會自動變更為 100。pageToken:屬於接收自前一個清單呼叫的網頁權杖。提供此權杖即可擷取後續網頁。