本文說明如何透過 Google Cloud Pub/Sub 接收及回應 Google Meet 事件。
Meet 事件代表 Meet 資源的活動或變更，例如建立新會議。您可以透過事件瞭解發生了什麼事，然後採取行動或以有意義的方式回應使用者。
以下列舉幾個事件的用途：
觀察並回應會議異動，例如會議開始或結束時。
追蹤出席會議的人員，以符合法規或訓練需求。
聆聽會議轉錄稿，以便剖析檔案內容，並記錄到客戶關係管理系統或資料庫。
活動的運作方式
每當 Google Meet 發生事件時，系統就會建立或更新 Google Meet REST API 資源。Meet 會使用事件將資訊傳送至應用程式，說明發生的活動類型和受影響的 Meet REST API 資源。
Space 資源。接著，Meet 會建立包含新會議空間資料的活動。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
」資源。 |
示例：擷取會議空間中參與者的相關事件
在這個範例中，Meet 應用程式想接收會議空間中參與者變更的相關資訊。在會議空間中，參與者加入進行中的會議，系統會填入 ParticipantSession 資源並觸發新事件。接著，您可以使用 subscribe 或 query 方法，取得這些事件的相關資訊。
訂閱活動
如要即時接收事件，Meet 應用程式會呼叫 Google Workspace Events API subscriptions.create 方法，訂閱所有類型的會議空間事件。建立訂閱項目後，Meet 應用程式就能開始接收事件。
在圖 2 中，Meet 應用程式已有效訂閱會議空間，因此每當會議空間中的參與者工作階段發生變化，應用程式就會收到事件。這樣一來，Meet 應用程式就能即時回應任何活動，例如得知參與者加入或離開進行中的會議。
如要瞭解如何使用 Google Workspace Events API 建立訂閱項目，請參閱 Google Workspace Events API 說明文件。
查詢近期活動
除了在事件發生時接收事件，Meet 應用程式也可以呼叫 Meet REST API，列出與參與者活動相關的近期會議空間事件。
在圖 3 中，所有參與者工作階段活動結束後，Meet 應用程式會呼叫 Meet REST API conferenceRecords.participants.participantSessions.list 方法。Meet REST API 會傳回 ParticipantSession 資源清單，代表各項變更。然後，Meet 應用程式就能根據近期活動處理或回應，例如建立加入和離開會議的參與者清單。
如要使用 Meet REST API 查詢活動，請參閱「列出所有參與者工作階段」。
限制
- 日曆受邀者和其他受邀參加會議的參與者，只能收到下列事件：
google.workspace.meet.conference.v2.started和google.workspace.meet.transcript.v2.fileGenerated。