本頁面說明應用程式可訂閱的 Google Meet 活動 透過 Google Workspace 事件 API 管理事件在您決定 您需要的事件類型、建立 訂閱即可開始接收 以及 Google Meet 中的活動
如要進一步瞭解如何開發支援 Google Meet 的應用程式,請參閱 Google Meet REST API。 總覽頁面。
支援的 Meet 事件
Google Workspace 訂閱可讓你接收 下列類型的 Meet 異動:
可監控事件的資源
如要接收活動,請指定要監控的 Meet 資源, 也就是訂閱項目的「目標資源」。
Google Workspace 活動 API 支援下列目標資源 Meet:
目標資源 | 格式 | 限制 (如適用) |
---|---|---|
會議空間 | //meet.googleapis.com/spaces/SPACE
其中 SPACE 是
Meet REST API |
|
使用者 | //cloudidentity.googleapis.com/users/USER
其中 USER 是
Meet REST API |
訂閱項目會收到與會議空間相關的事件, 就是下列其中一項:
|
用來建立訂閱的事件類型
建立 Meet 資源的訂閱時,您可以使用
eventTypes[]
] 欄位指定想要接收的事件類型。事件類型為
採用的格式為符合 CloudEvents 規格的格式,例如
google.workspace.APPLICATION.RESOURCE.VERSION.ACTION
。
舉例來說,如果想在某個時段收到新參與者的相關活動,
Meet 聊天室,請將活動類型指定為
google.workspace.meet.participant.v2.joined
。進一步瞭解事件
工作,請參閱「Google Workspace 架構
活動。
下表列出支援的事件類型、說明和 已變更事件資料中顯示的 Meet 資源:
事件類型 | 說明 | Meet 資源 |
---|---|---|
|
系統會在會議空間發起會議。 |
|
|
會議會在會議空間結束。 |
|
|
參與者在會議空間加入進行中的會議。 |
|
|
一位參與者在會議空間離開進行中的會議。 |
|
|
系統會為會議空間中的會議產生錄製檔案。 |
|
|
系統會為會議空間中的會議產生轉錄稿檔案。 |
|
事件資料
本節將說明 Meet 會議空間。
您的 Google Workspace 訂閱方案收到事件時
認識
data
欄位包含事件的酬載。這個酬載包含
已變更的 Google Workspace 資源。舉例來說,如果您已訂閱
事件中新轉錄稿的事件,這些事件的酬載中包含
關於
transcript
變更的資源
事件酬載中的資源資料
下表提供訂閱項目的 JSON 酬載範例
Meet 會議空間。範例使用
在空間中發生的 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" } } |
相關主題
- 教學課程:使用 Python 和 Google Meet REST API 觀察會議活動
- Google Workspace 事件結構
- 選擇 OAuth 範圍
- 建立訂閱項目,即可達成以下目的: 接收 Meet 活動
- Google Meet REST API 總覽