このドキュメントでは、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 イベントに登録するをご覧ください。
次の表に、イベントの登録とクエリの違いと理由を示します。
| イベントに登録する | データをクエリする | |
|---|---|---|
| ユースケース |
|
|
| API | Google Workspace Events API | Meet REST API |
| イベントのソース | 会議レコードとユーザー | スペースと会議レコード |
| サポートされるイベント |
会議レコード
サポートされているイベントタイプの一覧については、 サブスクリプションを作成するためのイベントタイプ（Google Workspace Events API ドキュメント内）をご覧ください。 |
スペースと会議レコード
サポートされているエンドポイントの一覧については、 Space
リソースと
ConferenceRecord
リソースを Meet REST API ドキュメントでご覧ください。
|
| イベントの形式 | CloudEvent 仕様に従ってフォーマットされた Google Cloud Pub/Sub メッセージ。詳しくは、 Google Workspace イベントの構造をご覧ください。 |
Meet REST API リソース（Space と ConferenceRecord）
|
| イベントデータ | リソースデータを含むまたは含まない Base64 エンコードされた文字列。ペイロードの例については、イベントデータをご覧ください。 |
リソースデータを含む JSON ペイロード。ペイロードの例については、リファレンス ドキュメントの
ConferenceRecord
リソースをご覧ください。
|
例: 会議スペースの参加者に関するイベントを取得する
この例では、Meet アプリが会議スペースの参加者の変更に関する情報を受信します。会議スペースで、参加者がアクティブな会議に参加すると、ParticipantSessionリソースが作成され、新しいイベントがトリガーされます。これらのイベントに関する情報は、
サブスクライブまたはクエリ
の方法で取得できます。
イベントに登録する
イベントをリアルタイムで受信するには、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。