本文說明如何透過 Google Cloud Pub/Sub 接收及回應 Google Meet 事件。
Meet 事件代表 Meet 資源的活動或變更,例如建立新會議。您可以透過事件瞭解發生了什麼事,然後採取行動或以有意義的方式回應使用者。
以下列舉幾個事件的用途:
觀察並回應會議異動,例如會議開始或結束時。
追蹤出席會議的人員,以符合法規或訓練需求。
聆聽會議轉錄稿,以便剖析檔案內容,並記錄到客戶關係管理系統或資料庫。
活動的運作方式
每當 Google Meet 發生事件時,系統就會建立或更新 Google Meet REST API 資源。Meet 會使用事件將資訊傳送至應用程式,說明發生的活動類型和受影響的 Meet REST API 資源。
Meet 會依類型分類活動。事件類型可協助您篩選及接收所需資訊,並以相同方式處理類似活動。
以下範例說明 Meet 中的活動如何影響相關的 Meet REST API 資源,以及 Meet 應用程式收到的事件類型:
| 活動 | 認識 Meet REST API 資源 | 事件類型 |
|---|---|---|
| 使用者加入會議空間。 | 已建立 ConferenceRecord 資源。 |
新分區戰績 |
接收 Google Meet 的事件資料
如要接收事件資料,應用程式可以採取下列任一做法:
使用 Google Workspace Events API 訂閱事件,即可在事件發生時收到通知。詳情請參閱「訂閱 Google Meet 事件」。
呼叫 Meet REST API 查詢近期資料。
下表說明訂閱事件與查詢事件的差異和原因:
| 訂閱事件 | 查詢資料 | |
|---|---|---|
| 用途 |
|
|
| API | Google Workspace Events API | Meet REST API |
| 事件來源 | 分區戰績和使用者 | 聊天室和會議記錄 |
| 支援的事件 |
會議記錄
如需支援的事件類型清單,請參閱 Google Workspace Events API 說明文件中的「 用於建立訂閱項目的事件類型」。 |
空間和會議記錄
如需支援的端點清單,請參閱 Meet REST API 說明文件中的 Space
資源和
ConferenceRecord
資源。
|
| 事件格式 | 根據 CloudEvent 規格格式化的 Google Cloud Pub/Sub 訊息。詳情請參閱「Google Workspace 事件的結構」。 |
Meet REST API 資源 (Space 和 ConferenceRecord)
|
| 事件資料 | Base64 編碼字串,可包含或不包含資源資料。如需範例酬載,請參閱「事件資料」。 |
包含資源資料的 JSON 酬載。如需有效負載範例,請參閱參考說明文件中的「ConferenceRecord
」資源。 |
限制
- 日曆受邀者和其他受邀參加會議的參與者,只能收到下列事件:
google.workspace.meet.conference.v2.started和google.workspace.meet.transcript.v2.fileGenerated。