訂閱 Google Meet 活動

本頁面說明應用程式可訂閱的 Google Meet 活動 透過 Google Workspace 事件 API 管理事件在您決定 您需要的事件類型、建立 訂閱即可開始接收 以及 Google Meet 中的活動

如要進一步瞭解如何開發支援 Google Meet 的應用程式,請參閱 Google Meet REST API。 總覽頁面

支援的 Meet 事件

Google Workspace 訂閱可讓你接收 下列類型的 Meet 異動:

  • A 罩杯 會議 發起或結束會議。
  • A 罩杯 參與者 加入或離開會議。
  • A 罩杯 錄影 為會議產生
  • A 罩杯 轉錄稿 為會議產生

可監控事件的資源

如要接收活動,請指定要監控的 Meet 資源, 也就是訂閱項目的「目標資源」

Google Workspace 活動 API 支援下列目標資源 Meet:

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

其中 SPACE Meet REST API space 資源的資源名稱。 詳情請參閱 做法 Meet 會識別會議空間

使用者 //cloudidentity.googleapis.com/users/USER

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

訂閱項目會收到與會議空間相關的事件, 就是下列其中一項:

  • 會議空間的擁有者。
  • 主辦人 輸入與會議空間相關的 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 訂閱方案收到事件時 認識 data 欄位包含事件的酬載。這個酬載包含 已變更的 Google Workspace 資源。舉例來說,如果您已訂閱 事件中新轉錄稿的事件,這些事件的酬載中包含 關於 transcript 變更的資源

事件酬載中的資源資料

下表提供訂閱項目的 JSON 酬載範例 Meet 會議空間。範例使用 在空間中發生的 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"
    }
}