このドキュメントでは、Google Cloud Pub/Sub から Google Meet イベントを受信して応答する方法について説明します。
Meet イベントは、新しい会議の作成など、Meet リソースのアクティビティまたは変更を表します。イベントを使用すると、何が起こったかを把握して対応したり、ユーザーにとって有益な方法で応答したりできます。
イベントの使用例を次に示します。
会議の開始や終了など、会議の変更を監視して応答します。
規制やトレーニングの目的で、会議の参加者を追跡する。
会議の文字起こしをリッスンして、ファイルの内容を解析し、CRM またはデータベースに記録します。
イベントの仕組み
Google Meet で何らかのイベントが発生すると、Google Meet REST API リソースが作成または更新されます。Meet は、イベントを使用して、発生したアクティビティのタイプと影響を受けた Meet REST API リソースに関する情報をアプリに配信します。
Space リソースが作成されます。Meet は、新しい会議スペースに関するデータを含むイベントを作成します。Meet では、イベントが種類別に分類されます。イベントタイプを使用すると、必要な種類の情報のみをフィルタして受信し、同様のアクティビティを同じ方法で処理できます。
次の例は、Meet のアクティビティが関連する Meet REST API リソースにどのように影響するかと、Meet アプリが受信するイベントのタイプを示しています。
| アクティビティ | Meet REST API リソース | イベントの種類 |
|---|---|---|
| ユーザーが会議スペースに参加します。 | ConferenceRecord リソースが作成されます。 |
新しい会議レコード |
Google Meet からイベントデータを受信する
イベントデータを受信するには、アプリで次のいずれかを行います。
Google Workspace Events API を使用してイベントに登録すると、イベントが発生したときにイベントを受信できます。詳しくは、Google Meet のイベントを購読するをご覧ください。
Meet REST API を呼び出して、最近のデータをクエリします。
次の表に、イベントのサブスクライブとクエリの違いと理由を示します。
| イベントに登録する | データのクエリ | |
|---|---|---|
| ユースケース |
|
|
| API | Google Workspace Events API | Meet REST API |
| イベントのソース | カンファレンスでの成績とユーザー | スペースと会議の記録 |
| サポートされるイベント |
会議の記録
サポートされているイベントタイプの一覧については、Google Workspace Events API ドキュメントの サブスクリプションを作成するためのイベントタイプをご覧ください。 |
スペースと会議の記録
サポートされているエンドポイントの一覧については、Meet REST API ドキュメントの Space リソースと ConferenceRecord リソースをご覧ください。 |
| イベントの形式 | CloudEvent 仕様に従ってフォーマットされた Google Cloud Pub/Sub メッセージ。詳しくは、Google Workspace イベントの構造をご覧ください。 |
Meet REST API リソース（Space と ConferenceRecord）
|
| イベントデータ | リソースデータを含むまたは含まない Base64 エンコード文字列。ペイロードの例については、イベントデータをご覧ください。 |
リソースデータを含む JSON ペイロード。ペイロードの例については、リファレンス ドキュメントの ConferenceRecord
リソースをご覧ください。 |
例: 会議スペースの参加者に関するイベントを取得する
この例では、Meet アプリが会議スペースの参加者の変更に関する情報を受け取ろうとしています。会議スペースで、参加者がアクティブな会議に参加すると、ParticipantSession リソースが入力され、新しいイベントがトリガーされます。これらのイベントに関する情報は、subscribe メソッドまたは query メソッドを使用して取得できます。
イベントに登録する
イベントをリアルタイムで受信するために、Meet アプリは Google Workspace Events API の subscriptions.create メソッドを呼び出して、すべてのタイプのイベントの会議スペースをサブスクライブします。サブスクリプションを作成すると、Meet アプリはイベントの受信を開始できます。
図 2 では、Meet アプリは会議スペースの定期購入が有効になっているため、会議スペースで参加者セッションが変更されるたびにイベントを受信します。これにより、Meet アプリは、参加者がアクティブな会議に参加または退出したタイミングなど、アクティビティにリアルタイムで対応できます。
Google Workspace Events API を使用してサブスクリプションを作成する方法については、Google Workspace Events API のドキュメントをご覧ください。
最近のイベントのクエリ
Meet アプリは、イベントが発生するたびにイベントを受信するだけでなく、Meet REST API を呼び出して、参加者のアクティビティに関連する最近の会議スペース イベントを一覧表示することもできます。
図 3 では、すべての参加者のセッション アクティビティが発生した後、Meet アプリが Meet REST API conferenceRecords.participants.participantSessions.list メソッドを呼び出しています。Meet REST API は、各変更を表す ParticipantSession リソースのリストを返します。Meet アプリは、会議に参加したユーザーと退出したユーザーのリストを作成するなど、最近のアクティビティに基づいて処理や応答を行うことができます。
Meet REST API を使用してイベントをクエリするには、すべての参加者セッションを一覧表示するをご覧ください。
制限事項
- カレンダーの招待者や会議に招待されたその他の参加者は、
google.workspace.meet.conference.v2.startedとgoogle.workspace.meet.transcript.v2.fileGeneratedのイベントのみを受け取ることができます。