このページでは、アプリが Google Workspace Events API を使用して登録できる Google Meet イベントについて説明します。必要なイベントの種類を決定したら、サブスクリプションを作成して、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 のリソース |
|---|---|---|
|
会議は会議スペースで始まります。 |
|
|
会議が会議スペースで終了する。 |
|
|
会議スペースで進行中の会議に参加します。 |
|
|
会議スペースで進行中の会議を参加者が退出しました。 |
|
|
会議スペースに会議の録画ファイルが生成されます。 |
|
|
会議スペースでの会議の文字起こしファイルが生成されます。 |
|
イベントデータ
このセクションでは、Meet 会議スペースのイベントデータとペイロードの例について説明します。
Google Workspace サブスクリプションが Meet からイベントを受信すると、data フィールドにイベントのペイロードが含まれます。このペイロードには、変更された Google Workspace リソースに関する情報が含まれています。たとえば、スペース内の新しい音声文字変換に関するイベントに登録している場合、これらのイベントのペイロードには、変更された transcript リソースに関する情報が含まれます。
イベント ペイロード内のリソースデータ
次の表に、Meet 会議スペースのサブスクリプションの JSON ペイロードの例を示します。この例では、スペースで行われる会議 conferenceRecords/AAA-BBB-CCC-DDD-EEE を使用します。サブスクリプションが受信するイベントごとに、ペイロードがイベントの data フィールドに表示されます。
| 例 | イベントの種類 | JSON ペイロード |
|---|---|---|
Meet 会議スペースの会議が始まります。 |
|
リソースデータを除く
{
"conferenceRecord":
{
"name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE"
}
}
|
| 参加者が Meet の会議スペースで会議に参加します。 |
|
リソースデータを除く
{
"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"
}
}
|