訂閱 Google Meet 活動

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

如要進一步瞭解如何開發 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 酬載範例。這些範例會使用會議記錄 ID (例如 conferenceRecords/AAA-BBB-CCC-DDD-EEE) 來識別會議空間。詳情請參閱「Meet 如何識別會議空間」。

訂閱項目收到的每個事件,其酬載都會顯示在事件的 data 欄位中:

範例 事件類型 JSON 酬載

系統會為 Meet 會議空間發起電話會議。

google.workspace.meet.conference.v2.started

不包含資源資料
{
    "conferenceRecord":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID"
    }
}
      
參與者在 Meet 會議空間加入會議。

google.workspace.meet.participant.v2.joined

不包含資源資料
{
    "participantSession":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
    }
}
      
系統會為 Meet 會議空間中的會議生成錄製內容。 google.workspace.meet.recording.v2.fileGenerated
不包含資源資料
{
    "recording":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
    }
}
      
系統會為 Meet 會議空間中的會議生成轉錄稿。 google.workspace.meet.transcript.v2.fileGenerated
不包含資源資料
{
    "transcript":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/transcripts/TRANSCRIPT_ID"
    }
}