Google Meet のイベントに登録する

このドキュメントでは、Google Workspace Events API を使用してアプリが登録できる Meet イベントについて説明します。必要なイベントの種類を決定したら、サブスクリプションを作成して、Meet からイベントの受信を開始します。

イベントをサブスクライブするだけでなく、Google Meet REST API を呼び出してイベントをクエリすることもできます。Meet REST API を呼び出して、定期的にイベントを取得したり、サービス停止が原因でサブスクリプションから見逃したイベントをキャッチアップしたりします。Meet イベントを受信して応答する方法については、Meet のドキュメントの Google Meet からのイベントに応答するをご覧ください。

Meet 用アプリの開発について詳しくは、 Meet REST API の概要をご覧ください。

サポートされている Meet イベント

Google Workspace サブスクリプションでは、Meet で行われた次の種類の変更に関するイベントを受信できます。

• 会議スペースで会議が開始または終了した。
• 参加者が会議に参加または会議から退出した。
• 会議の録画が開始または終了したとき、またはファイルが生成されたとき。
• 会議でスマートメモが開始または終了したとき、またはファイルが生成されたとき。
• 会議の文字起こしが開始または終了したとき、またはファイルが生成されたとき。

イベントをモニタリングできるリソース

イベントを受信するには、モニタリングする Meet リソースを指定します。これは、サブスクリプションのターゲット リソースと呼ばれます。

Google Workspace Events API は、Meet の次のターゲット リソースをサポートしています。

サブスクリプションを作成するためのイベントタイプ

Meet リソースへのサブスクリプションを作成するときに、eventTypes[] フィールドを使用して、受信するイベントのタイプを指定します。イベントタイプは、CloudEvents 仕様に従ってフォーマットされます（例: google.workspace.APPLICATION.RESOURCE.VERSION.ACTION）。

たとえば、Meet スペースの会議に新しい参加者が参加したときにイベントを受信するには、イベントタイプを google.workspace.meet.participant.v2.joined として指定します。イベントの仕組みについて詳しくは、Google Workspace イベントの構造をご覧ください。

次の表に、Meet リソースのサブスクリプションでサポートされているイベントタイプを示します。

イベントデータ

このセクションでは、Meet の会議スペースでのイベントのイベントデータとペイロードの例について説明します。

Google Workspace サブスクリプションが Meet からイベントを受信すると、data フィールドにイベントのペイロードが含まれます。このペイロードには、変更された Google Workspace リソースに関する情報が含まれています。たとえば、スペース内の新しい文字起こしに関するイベントに登録している場合、これらのイベントのペイロードには、変更された transcripts リソースに関する情報が含まれます。

イベント ペイロードのリソースデータ

次の表に、Meet 会議スペースのサブスクリプションの JSON ペイロードの例を示します。この例では、会議レコード ID（conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ など）を使用して会議スペースを識別します。詳細については、Meet が会議スペースを識別する方法をご覧ください。

サブスクリプションが受信するイベントごとに、ペイロードがイベントの data フィールドに表示されます。

{
  "conferenceRecord":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID"
  }
}
      

{
  "participantSession":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
  }
}
      

{
  "recording":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
  }
}
      

{
  "smartNote":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/smartNotes/SMART_NOTE_ID"
  }
}
      

{
  "transcript":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/transcripts/TRANSCRIPT_ID"
  }
}
      

• カレンダーの招待者と会議に招待された他の参加者が受信できるのは、google.workspace.meet.conference.v2.started と google.workspace.meet.transcript.v2.fileGenerated のイベントのみです。

関連トピック

• Google Workspace Events API の概要
• Google Workspace イベントの構造
• Google Workspace Events API のスコープを選択する
• Google Meet REST API の概要
• Meet REST API のスコープを選択する
• チュートリアル: Python と Google Meet REST API を使用して会議イベントをモニタリングする