このドキュメントでは、Google Cloud Pub/Sub から Google Meet イベントを受信して応答する方法について説明します。
Meet イベントは、新しい会議の作成など、Meet リソースのアクティビティまたは変更を表します。イベントを使用すると、何が起こったかを把握して対応したり、ユーザーにとって有益な方法で応答したりできます。
イベントの使用例を次に示します。
会議の開始や終了など、会議の変更を監視して応答します。
規制やトレーニングの目的で、会議の参加者を追跡する。
会議の文字起こしをリッスンして、ファイルの内容を解析し、CRM またはデータベースに記録します。
イベントの仕組み
Google Meet で何らかのイベントが発生すると、Google Meet REST API リソースが作成または更新されます。Meet は、イベントを使用して、発生したアクティビティのタイプと影響を受けた Meet REST API リソースに関する情報をアプリに配信します。
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
リソースをご覧ください。 |
制限事項
- カレンダーの招待者や会議に招待されたその他の参加者は、
google.workspace.meet.conference.v2.startedとgoogle.workspace.meet.transcript.v2.fileGeneratedのイベントのみを受け取ることができます。