本文說明應用程式可透過 Google Workspace Events API 訂閱的 Meet 事件。決定所需的事件類型後，請建立訂閱項目，開始接收 Meet 的事件。
除了訂閱事件，您也可以呼叫 Google Meet REST API 查詢事件。呼叫 Meet REST API，定期擷取事件，或補上因服務中斷而錯過的訂閱事件。如要瞭解如何接收及回覆 Meet 活動，請參閱 Meet 說明文件中的「回覆 Google 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。