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

このページでは、アプリが Google Workspace Events API を使用して登録できる Google Meet イベントについて説明します。

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

サポートされている Meet のターゲット リソース

Meet イベントを受信するために、Google Workspace Events API では次のリソースのサブスクリプションがサポートされています。

  • space リソースとして表される会議スペース。
  • Cloud Identity API の user リソースとして表されるユーザー。

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

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

  • 会議は、会議スペース内で開始または終了します。
  • 参加者が会議に参加または会議から退出した場合。
  • 会議の録画が生成されます。
  • 会議の文字起こしが生成されます。

Meet リソースのサブスクリプションを作成する場合は、eventTypes[] フィールドを使用して、受信するイベントの種類を指定します。イベントタイプは、google.workspace.APPLICATION.RESOURCE.VERSION.ACTION などの CloudEvents 仕様に従ってフォーマットされます。たとえば、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 ペイロードの例を示します。この例では、スペースで行われる会議 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"
    }
}