參與者是指加入通話或使用夥伴模式的使用者,他們以觀看者的身份觀看,或是連線至通話的會議室裝置。每個人都有一個 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
將父項值替換為會議記錄的名稱。
搜尋特定參與者
如要搜尋特定參與者,請在 conferenceRecords.participants
資源上使用 get()
方法,並搭配 name
路徑參數。如要擷取參與者名稱,請使用 conferenceRecords.participants.list
方法。
這個方法會將參與者名稱傳回為 conferenceRecords.participants
資源的例項。
以下程式碼範例說明如何擷取特定參與者:
Java
Node.js
Python
將參與者名稱替換為要尋找的特定參與者名稱。
參與者工作階段
以下各節將詳細說明如何取得參與者工作階段的相關資訊。
搜尋所有參與者的工作階段
如要取得會議記錄中參與者所有參與者工作階段的詳細資料,請使用 conferenceRecords.participants.participantSessions
資源的 list()
方法,並搭配 parent
路徑參數。
您可以使用 startTime
或 endTime
欄位,篩選出在特定時間之前加入,或在特定時間之後離開的使用者。兩個欄位都使用 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
將父項值替換為會議記錄名稱和參與者名稱。
搜尋特定參與者的工作階段
如要搜尋特定參與者工作階段,請在 conferenceRecords.participants.participantSessions
資源上使用 name
路徑參數的 get()
方法。如要擷取參與者名稱,請使用 list()
方法。
這個方法會將參與者名稱傳回為 conferenceRecords.participants.participantSessions
資源的例項。
以下程式碼範例說明如何擷取特定參與者的工作階段:
Java
Node.js
Python
將參與者名稱替換為要尋找的特定參與者名稱。
使用 People API 擷取參與者詳細資料
如要擷取參與者詳細資料,請使用 People API 中的 people.get
方法。
- 使用路徑的結尾元件,從參與者資源名稱中擷取使用者 ID。舉例來說,如果參與者資源名稱為
conferenceRecords/abc-123/participants/12345
,People API 的 ID 就是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