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 で行われた次の種類の変更に関するイベントを受信できます。

• 会議スペースで会議が開始または終了します。
• 参加者が会議に参加または退出する。
• 会議の録画が開始、終了したか、ファイルが生成された。
• スマートメモが開始または終了したとき、または会議のファイルが生成されたとき。science デベロッパー プレビュー
• 会議の文字起こしが開始、終了、またはファイルが生成された場合。

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

イベントを受信するには、モニタリングする 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 の概要
• Google Meet REST API のスコープを選択する
• チュートリアル: Python と Google Meet REST API を使用して会議イベントをモニタリングする