訂閱 Google Meet 活動

本頁面說明應用程式可使用 Google Workspace Events API 訂閱的 Google Meet 事件。決定所需的事件類型後，請建立訂閱項目，開始接收 Google Meet 的事件。

如要進一步瞭解如何開發 Google Meet 應用程式，請參閱 Google Meet REST API 總覽。

支援的 Meet 事件

訂閱 Google Workspace 後，您就能接收有關 Meet 以下類型變更的事件：

  • 會議是在會議空間中開始或結束。
  • 參與者加入或離開會議。
  • 系統會為會議產生錄音。
  • 系統會為會議產生轉錄稿。

可監控事件的資源

如要接收事件，您必須指定要監控的 Meet 資源，這稱為訂閱的目標資源。

Google Workspace Events API 支援 Meet 的下列目標資源：

目標資源 格式 限制 (如有)
會議空間 //meet.googleapis.com/spaces/SPACE

其中 SPACE 是 Meet REST API space 資源的 資源名稱中的 ID。詳情請參閱「Meet 如何識別會議空間」。
使用者 //cloudidentity.googleapis.com/users/USER

其中 USER 是 Meet REST API participant 資源的 signedinUser.user 欄位中的 ID。詳情請參閱「與參與者合作」。

訂閱項目會接收會議空間的事件，其中使用者為下列任一類別：

  • 會議空間的擁有者。
  • 與會議空間相關聯的 Google 日曆活動主辦人。

建立訂閱項目的事件類型

建立 Meet 資源的訂閱項目時，請使用 eventTypes[] 欄位指定要接收哪些類型的事件。事件類型會依照 CloudEvents 規格設定格式，例如 google.workspace.APPLICATION.RESOURCE.VERSION.ACTION。舉例來說，如要接收 Meet 聊天室會議中新參與者的事件，請將事件類型指定為 google.workspace.meet.participant.v2.joined。如要進一步瞭解事件的運作方式，請參閱「Google Workspace 事件結構」。

下表列出支援的事件類型、說明，以及事件資料中所代表的變更 Meet 資源：

事件類型 說明 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.fileGenerated

會議空間中的會議會產生錄製檔案。

conferenceRecord.recording

google.workspace.meet.transcript.v2.fileGenerated

系統會為會議空間中的會議產生逐字稿檔案。

conferenceRecord.transcript

事件資料

本節說明 Meet 會議空間中事件的事件資料和酬載範例。

當 Google Workspace 訂閱方案收到 Meet 的事件時，data 欄位會包含事件的酬載。這個酬載包含變更的 Google Workspace 資源相關資訊。舉例來說，如果您訂閱聊天室中新字幕的事件，這些事件的酬載就會包含變更的 transcript 資源相關資訊。

事件酬載中的資源資料

下表提供 Meet 會議空間訂閱項目的 JSON 酬載範例。範例會使用在聊天室中進行的會議 conferenceRecords/AAA-BBB-CCC-DDD-EEE。對於訂閱項目收到的每個事件，酬載都會顯示在事件的 data 欄位中：

範例 事件類型 JSON 酬載

Meet 會議空間開始進行會議。

google.workspace.meet.conference.v2.started

排除資源資料
{
    "conferenceRecord":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE"
    }
}
參與者在 Meet 會議空間中加入會議。

google.workspace.meet.participant.v2.joined

排除資源資料
{
    "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"
    }
}