訂閱 Google Meet 活動

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

除了訂閱事件外，您也可以呼叫 Google Meet REST API 查詢事件。定期呼叫 Meet REST API 擷取事件，或補回因服務中斷而錯過的訂閱事件。如要瞭解如何接收及回覆 Meet 活動，請參閱 Meet 說明文件中的「透過 Google 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 spaces 資源的 資源名稱中的 ID。 詳情請參閱「Meet 如何識別會議空間」。
使用者 //cloudidentity.googleapis.com/users/USER

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

訂閱項目會接收使用者擁有會議空間的所有會議空間事件。通常會議空間擁有者也是與會議空間相關聯的 Google 日曆活動發起人。

建立訂閱項目的事件類型

建立 Meet 資源的訂閱項目時，請使用 eventTypes[] 欄位指定要接收的事件類型。事件類型會根據 CloudEvents 規格格式化，例如 google.workspace.APPLICATION.RESOURCE.VERSION.ACTION。

舉例來說，如要接收 Meet 空間會議中新參與者的相關事件，請將事件類型指定為 google.workspace.meet.participant.v2.joined。如要進一步瞭解事件的運作方式，請參閱「Google Workspace 事件結構」。

下表列出訂閱 Meet 資源時支援的事件類型：

事件類型 格式 資源資料
會議空間會發起會議。 google.meet.conference.v2.started conferenceRecord
會議空間中的會議結束。 google.meet.conference.v2.ended conferenceRecord
參與者在會議空間中加入進行中的視訊會議。 google.meet.participant.v2.joined conferenceRecord.participantSession
參與者離開會議空間中的進行中會議。 google.meet.participant.v2.left conferenceRecord.participantSession
系統會為會議空間中的會議產生錄製檔案。 google.meet.recording.v2.fileGenerated conferenceRecord.recording
系統會為會議空間中的會議產生轉錄稿檔案。 google.meet.transcript.v2.fileGenerated conferenceRecord.transcript

事件資料

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

當 Google Workspace 訂閱方案收到 Meet 的事件時，data 欄位會包含該事件的酬載。這個酬載包含變更的 Google Workspace 資源相關資訊。舉例來說，如果您訂閱了空間中新轉錄稿的相關事件，這些事件的酬載會包含 transcripts 資源的變更資訊。

事件酬載中的資源資料

下表提供訂閱 Meet 會議空間的 JSON 酬載範例。這些範例使用會議記錄 ID (例如 conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ) 來識別會議空間。詳情請參閱「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"
    }
}

限制
  • 日曆受邀者和其他受邀參加會議的參與者，只能收到下列事件：google.workspace.meet.conference.v2.started 和 google.workspace.meet.transcript.v2.fileGenerated。