本文說明應用程式可使用 Google Workspace Events API 訂閱的 Meet 事件。決定需要的事件類型後，請建立訂閱項目，開始接收 Meet 的事件。
除了訂閱事件，您也可以呼叫 Google Meet REST API 查詢事件。定期呼叫 Meet REST API 擷取事件，或補齊因服務中斷而錯過的訂閱事件。如要瞭解如何接收及回覆 Meet 活動邀請，請參閱 Meet 說明文件中的「從 Meet 回覆活動邀請」。
如要進一步瞭解如何開發 Meet 應用程式，請參閱「 Meet REST API 總覽」。
支援的 Meet 事件
透過 Google Workspace 訂閱方案，您可以接收下列 Meet 變更類型的事件：
可監控事件的資源
如要接收事件，請指定要監控的 Meet 資源，也就是訂閱的目標資源。
Google Workspace Events API 支援下列 Meet 目標資源：
| 目標資源 | 格式 | 限制 (如適用) |
|---|---|---|
| 會議空間 | //meet.googleapis.com/spaces/SPACE
其中 SPACE 是 Meet REST API |
|
| 使用者 | //cloudidentity.googleapis.com/users/USER
其中 USER 是 Meet REST API |
訂閱項目會接收使用者是會議空間擁有者的所有會議空間事件。通常，會議空間擁有者也是與會議空間相關聯的 Google 日曆活動發起人。 |
建立訂閱項目的事件類型
建立 Meet 資源的訂閱項目時，請使用 eventTypes[] 欄位指定要接收的事件類型。事件類型會根據 CloudEvents 規格格式化，例如 google.workspace.APPLICATION.RESOURCE.VERSION.ACTION。
舉例來說，如要接收 Meet 空間中新參與者相關的事件，請將事件類型指定為 google.workspace.meet.participant.v2.joined。如要進一步瞭解事件的運作方式，請參閱「Google Workspace 事件結構」。
下表列出訂閱 Meet 資源時支援的事件類型：
| 事件類型 | 格式 | 資源資料 |
|---|---|---|
| 會議空間會發起會議。 | google.workspace.meet.conference.v2.started |
conferenceRecord |
| 會議空間中的會議結束。 | google.workspace.meet.conference.v2.ended |
conferenceRecord |
| 出席者在會議空間中加入進行中的會議。 | google.workspace.meet.participant.v2.joined |
conferenceRecord.participantSession |
| 出席者離開會議空間中的進行中會議。 | google.workspace.meet.participant.v2.left |
conferenceRecord.participantSession |
| 系統會在會議空間中開始錄製會議。 | google.workspace.meet.recording.v2.started |
conferenceRecord.recording |
| 會議空間中的會議錄製作業已結束。 | google.workspace.meet.recording.v2.ended |
conferenceRecord.recording |
| 系統會為會議空間中的會議產生錄製檔案。 | google.workspace.meet.recording.v2.fileGenerated |
conferenceRecord.recording |
| 會議室會開始為會議建立智慧筆記。 | google.workspace.meet.smartNote.v2.started |
conferenceRecord.smartNote |
| 會議空間中的會議結束後，智慧筆記就會停止記錄。 | google.workspace.meet.smartNote.v2.ended |
conferenceRecord.smartNote |
| 系統會為會議空間中的會議產生智慧筆記檔案。 | google.workspace.meet.smartNote.v2.fileGenerated |
conferenceRecord.smartNote |
| 會議空間中的會議會開始轉錄。 | google.workspace.meet.transcript.v2.started |
conferenceRecord.transcript |
| 會議空間中的會議轉錄稿已結束。 | google.workspace.meet.transcript.v2.ended |
conferenceRecord.transcript |
| 系統會為會議空間中的會議產生轉錄稿檔案。 | google.workspace.meet.transcript.v2.fileGenerated |
conferenceRecord.transcript |
事件資料
本節說明 Meet 會議空間中的事件資料和範例酬載。
當 Google Workspace 訂閱方案收到 Meet 的事件時，data 欄位會包含該事件的酬載。這個酬載包含變更的 Google Workspace 資源相關資訊。舉例來說，如果您訂閱了有關聊天室新轉錄稿的事件，這些事件的酬載會包含有關變更的 transcripts 資源資訊。
事件酬載中的資源資料
下表提供訂閱 Meet 會議空間的 JSON 酬載範例。這些範例使用會議記錄 ID (例如 conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ) 來識別會議空間。詳情請參閱「Meet 如何識別會議空間」。
訂閱項目收到的每個事件，都會在事件的 data 欄位中顯示酬載：
| 事件類型 | JSON 酬載 |
|---|---|
Meet 會議空間的會議開始或結束。
|
不包含資源資料：
{
"conferenceRecord":
{
"name": "conferenceRecords/ |
出席者在 Meet 會議空間中加入或離開會議。
|
不包含資源資料：
{
"participantSession":
{
"name": "conferenceRecords/ |
在 Meet 會議空間中，會議開始或結束錄製，或是產生會議檔案。
|
不包含資源資料：
{
"recording":
{
"name": "conferenceRecords/ |
在 Meet 會議空間中，智慧筆記開始、結束或產生會議檔案。
|
不包含資源資料：
{
"smartNote":
{
"name": "conferenceRecords/ |
在 Meet 會議空間中，會議轉錄稿開始、結束或產生檔案。
|
不包含資源資料：
{
"transcript":
{
"name": "conferenceRecords/ |
限制
- 受邀參加會議的日曆邀請對象和其他參與者，只能收到下列事件：
google.workspace.meet.conference.v2.started和google.workspace.meet.transcript.v2.fileGenerated。