本頁面說明應用程式可使用 Google Workspace Event API 訂閱的 Google Meet 事件。決定需要的事件類型後,請建立訂閱項目,即可開始從 Google Meet 接收事件。
如要進一步瞭解如何開發適用於 Google Meet 的應用程式,請參閱「Google Meet REST API 總覽」。
支援的 Meet 目標資源
為了接收 Meet 活動,Google Workspace Event API 支援訂閱以下資源的訂閱功能:
- 會議空間,以
space
資源表示。 - 使用者,以 Cloud Identity API
user
資源表示。
支援的 Meet 活動
Google Workspace 訂閱可讓您接收下列 Meet 異動類型的事件:
為 Meet 資源建立訂閱項目時,您可以使用 eventTypes[]
欄位指定要接收的事件類型。事件類型會根據 CloudEvents 規格設定格式,例如 google.workspace.APPLICATION.RESOURCE.VERSION.ACTION
。舉例來說,如要在 Meet 空間的會議中接收有關新參與者的事件,您必須將事件類型指定為 google.workspace.meet.participant.v2.joined
。如要進一步瞭解事件的運作方式,請參閱「Google Workspace 事件結構」。
下表列出支援的事件類型、說明,以及事件資料所代表的變更 Meet 資源:
事件類型 | 說明 | Meet 資源 |
---|---|---|
|
系統會在會議聊天室中發起會議。 |
|
|
會議會在會議空間結束。 |
|
|
參與者會在會議場地加入進行中的會議。 |
|
|
某位參與者在會議場地離開進行中的會議。 |
|
|
系統會為會議空間中的會議產生錄製檔案。 |
|
|
系統會為會議場地中的會議產生轉錄稿檔案。 |
|
事件資料
本節說明 Meet 會議空間事件的事件資料和範例酬載。
當您的 Google Workspace 訂閱收到來自 Meet 的事件時,data
欄位會包含該事件的酬載。此酬載包含已變更 Google Workspace 資源的相關資訊。舉例來說,如果您訂閱聊天室中有關新轉錄稿的事件,這些事件的酬載會包含變更的 transcript
資源相關資訊。
事件酬載中的資源資料
下表提供 Meet 會議空間訂閱項目的 JSON 酬載範例。這些範例使用在空間中進行的會議 conferenceRecords/AAA-BBB-CCC-DDD-EEE
。針對訂閱項目收到的每個事件,酬載都會顯示在事件的 data
欄位中:
範例 | 事件類型 | JSON 酬載 |
---|---|---|
系統會開始透過 Meet 會議空間發起會議。 |
|
排除資源資料
{ "conferenceRecord": { "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE" } } |
參與者將加入 Meet 會議空間的會議。 |
|
排除資源資料
{ "participantSession": { "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/participants/FFF-GGG-HHH-III-JJJ/participantSessions/LLL-MMM-NNN-OOO-PPP" } } |
系統會為 Meet 會議空間中的會議產生錄製內容。 | google.workspace.meet.recording.v2.fileGenerated |
排除資源資料
{ "recording": { "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/recordings/LLL-MMM-NNN-OOO-PPP" } } |
系統會針對 Meet 會議空間中的會議產生轉錄稿。 | google.workspace.meet.transcript.v2.fileGenerated |
排除資源資料
{ "transcript": { "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/transcripts/PPP-QQQ-RRR-SSS-TTT" } } |