訂閱 Google Meet 活動

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

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

支援的 Meet 目標資源

為了接收 Meet 活動，Google Workspace Event API 支援訂閱以下資源的訂閱功能：

  • 會議空間，以 space 資源表示。
  • 使用者，以 Cloud Identity API user 資源表示。

支援的 Meet 活動

Google Workspace 訂閱可讓您接收下列 Meet 異動類型的事件：

為 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"
    }
}