參與者是指加入通話的使用者、使用夥伴模式、以觀看者的身分觀看,或是使用與通話連線的會議室裝置。每個人都有一項 conferenceRecords.participants
資源。
「參與者工作階段」是針對加入通話的每個參與者和裝置配對建立的專屬工作階段 ID。每個工作階段都有一項 conferenceRecords.participants.participantSessions
資源。如果參與者透過同一參與者/裝置配對多次加入同一場通話,系統會分別指派不重複的工作階段 ID。
本頁說明如何取得所有參加或僅參與會議的參與者的相關資訊,或僅取得單一參與者的相關資訊,以及他們的工作階段資訊。
參與者
以下各節將詳細說明如何取得參與者的相關資訊。
conferenceRecords.participants
資源包含 user
欄位。user
只能是下列其中一種物件:
signedinUser
可以是下列其中一項:使用者透過個人電腦、行動裝置或夥伴模式加入會議。
會議室裝置使用的機器人帳戶。
anonymousUser
是未登入 Google 帳戶的不明使用者。phoneUser
是指使用者透過手機撥入會議,但使用者身分不明,因為使用者並未使用 Google 帳戶登入。
搜尋所有參與者
如要取得會議記錄中所有參與者的詳細資料,請在 conferenceRecords.participants
資源上使用 parent
路徑參數的 list()
方法。
您可以使用 earliestStartTime
或 latestEndTime
欄位,篩選出在特定時間前後加入的使用者。這兩個欄位都使用 RFC 3339 世界標準時間「Zulu」格式的時間戳記格式,採用奈秒解析度和最多九個小數位數:{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
。例如:
earliestStartTime < 2023-10-01T15:01:23Z
latestEndTime < 2023-10-01T15:01:23Z
如要吸引現有會議中的活躍參與者,請使用 latestEndTime IS
NULL
。
這個方法會傳回會議參與者清單,以遞減順序排序,做為 conferenceRecords.participants
資源的執行個體。
以下程式碼範例說明如何列出會議記錄中的所有參與者:
Java
Node.js
Python
以會議記錄名稱取代父項值。
搜尋特定參與者
如要搜尋特定參與者,請搭配 name
路徑參數在 conferenceRecords.participants
資源上使用 get()
方法。如要擷取參與者的名稱,請使用 conferenceRecords.participants.list
方法。
這個方法會傳回參與者名稱做為 conferenceRecords.participants
資源的執行個體。
以下程式碼範例說明如何擷取特定參與者:
Java
Node.js
Python
將參與者名稱換成要尋找的參與者名稱。
參與者工作階段
以下各節將詳細說明如何取得參與者工作階段的資訊。
搜尋所有參與者工作階段
如要取得會議錄製內容中某位參與者的所有參與者工作階段詳細資料,請使用具有 parent
路徑參數的 conferenceRecords.participants.participantSessions
資源上的 list()
方法。
您可以使用 startTime
或 endTime
欄位,篩選出在特定時間之前或之後加入的使用者。這兩個欄位都使用 Timestamp 格式,採 RFC 3339 世界標準時間「Zulu」格式,採用奈秒解析度和最多九個小數位數:{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
。例如:
startTime < 2023-10-01T15:01:23Z
endTime < 2023-10-01T15:01:23Z
這個方法會傳回參與者工作階段清單,以遞減順序排序,做為 conferenceRecords.participants.participantSession
資源的執行個體。
以下程式碼範例說明如何在會議記錄中列出所有參與者工作階段:
Java
Node.js
Python
將父項值替換為會議記錄名稱和參與者名稱。
搜尋特定的參與者工作階段
如要搜尋特定的參與者工作階段,請搭配 name
路徑參數在 conferenceRecords.participants.participantSessions
資源上使用 get()
方法。如要擷取參與者的名稱,請使用 list()
方法。
這個方法會傳回參與者名稱做為 conferenceRecords.participants.participantSessions
資源的執行個體。
以下程式碼範例說明如何擷取特定參與者工作階段:
Java
Node.js
Python
將參與者名稱換成要尋找的參與者名稱。