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

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

Google 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[] フィールドを使用して、受信するイベントの種類を指定します。イベントタイプは、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"
    }
}