參與者是指加入
呼叫或使用夥伴視窗模式
模式、以觀看者身分觀看,或是
已連線至通話的房間裝置先上傳
conferenceRecords.participants
敬上
為個別使用者設定資源
參與者工作階段是指
為加入通話的每個參與者裝置組合建立的專屬工作階段 ID。
先上傳
conferenceRecords.participants.participantSessions
敬上
每個工作階段的資源參與者多次加入同一場通話
也會指派不重複的工作階段 ID。
本頁說明如何取得所有參與者 (已參加或正在參加會議) 或單一參與者的資訊,以及他們的工作階段資訊。
參與者
以下各節將詳細說明如何取得參與者相關資訊。
conferenceRecords.participants
資源包含 user
欄位。user
只能採用下列其中一種設定
物件:
signedinUser
為以下任一項:透過個人電腦、行動裝置或 經由夥伴模式傳送
會議室裝置使用的機器人帳戶。
anonymousUser
是未登入 Google 帳戶的不明使用者。phoneUser
是使用者透過電話撥入會議,但使用者身分不明 因為他們未使用 Google 帳戶登入。
搜尋所有參與者
如要取得會議記錄中所有參與者的詳細資訊,請使用
list()
敬上
方法
conferenceRecords.participants
使用 parent
路徑參數的資源。
您可以使用「earliestStartTime
」或「latestEndTime
」欄位篩選以下項目:
在特定時間之後加入或離開的使用者。這兩個欄位都使用
時間戳記
格式,例如 RFC 3339
世界標準時間「Zulu」格式,解析度為奈秒,且最多 9 個小數位數:
{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
請將父項值替換為會議記錄的名稱。
搜尋特定參與者
如要搜尋特定參與者,請使用
get()
敬上
方法
conferenceRecords.participants
使用 name
路徑參數的資源。如要擷取
此時請使用 conferenceRecords.participants.list
方法。
這個方法會傳回參與者名稱,做為
conferenceRecords.participants
項資源。
以下程式碼範例說明如何擷取特定參與者:
Java
Node.js
Python
將參與者名稱替換為要尋找的特定參與者名稱。
參與者工作階段
以下各節將詳細說明如何取得參與者會議相關資訊。
搜尋所有參與者工作階段
如何取得特定會議參與者的所有會議詳細資訊
紀錄,請使用
list()
敬上
方法
conferenceRecords.participants.participantSessions
使用 parent
路徑參數的資源。
您可以使用 startTime
或 endTime
欄位,篩選出在特定時間之前加入或之後離開的使用者。這兩個欄位都使用
時間戳記
RFC 格式
3339 (世界標準時間)
「祖魯」格式,解析度為奈秒,且最多 9 個小數位數:
{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
將父項值替換為會議記錄名稱和 參與者名稱。
搜尋特定參與者工作階段
如要搜尋特定參與者工作階段,請在 conferenceRecords.participants.participantSessions
資源上使用 name
路徑參數的 get()
方法。如要擷取
此時請使用 list()
方法。
這個方法會傳回參與者名稱,做為
conferenceRecords.participants.participantSessions
項資源。
以下程式碼範例說明如何擷取特定參與者工作階段:
Java
Node.js
Python
將參與者名稱換成要尋找的參與者名稱。
使用 People API 擷取參與者詳細資料
如要擷取參與者的詳細資料,請使用
people.get
方法
People API。
- 使用
路徑的尾端元件舉例來說,如果參與者資源名稱
是
conferenceRecords/abc-123/participants/12345
的 ID People API 為12345
。 - 加入來源
READ_SOURCE_TYPE_PROFILE
、READ_SOURCE_TYPE_CONTACT
、 和READ_SOURCE_TYPE_OTHER_CONTACT
。這樣一來,回應內容就會包含 Google Workspace 機構內部使用者和外部聯絡人。
以下範例會同時搜尋機構個人資料和聯絡人 人物:
cURL
curl \
'https://people.googleapis.com/v1/people/PERSON_ID?personFields=names%2CemailAddresses&sources=READ_SOURCE_TYPE_OTHER_CONTACT&sources=READ_SOURCE_TYPE_PROFILE&sources=READ_SOURCE_TYPE_CONTACT' \
--header 'Authorization: Bearer ACCESS_TOKEN' \
--header 'Accept: application/json' \
--compressed