Google Meet REST API の概要

Google Meet REST API を使用すると、Google Meet の会議を作成して管理し、アプリからユーザーに直接エントリ ポイントを提供できます。

Meet REST API を使用すると、次のことができます。

• 会議スペースを作成して構成し、ユーザーがビデオでつながれるようにします。
• スペースのアクセスレベル、管理設定、自動録画や文字起こしを事前に構成します。
• 会議スペースのメンバーを管理し、共同主催者の役割を割り当てます。
• 会議スペース内でアクティブな会議をプログラムで終了します。
• 会議の記録、出席の詳細、参加者のセッション メタデータを取得します。
• 会議の成果物（録画、文字起こし、文字起こしエントリ、スマートメモ）を取得します。

Google Workspace Events API を使用して Meet イベントに登録することもできます。変更の通知を受け取るには、特定の会議スペースまたは特定のユーザーに属するすべての会議スペースを登録します。詳しくは以下をご覧ください。

• Google Meet から予定に返信する
• Google Workspace Events API を使用してイベントに登録する
• Google Meet のイベントを購読する

ユースケース

アプリは Meet REST API と統合して、次のタスクを実行できます。

• 会議前: 会議スペースをオンデマンドで作成し、アクセス制限（公開、信頼できるユーザー、制限付き）を事前構成し、モデレーション コントロール（画面共有、チャット、リアクション、マイク、カメラ）を適用し、自動録画または自動文字起こしを構成し、共同主催者の役割を持つスペース メンバーを割り当てます。

• 会議中: アクティブな会議のメタデータと参加者のセッションを取得する、メンバーを動的に管理する、Google Workspace Events API を使用してリアルタイムのライフサイクル イベントをリッスンする、アクティブな会議をプログラムで終了する。

• 会議後: 会議の記録と出席ログを取得し、Google ドライブから録画、Google ドキュメントの文字起こし、スマートノートをダウンロードします。また、コーチング、コンプライアンス、AI 分析のために、文字起こしされた発言の詳細なエントリにアクセスします。

Meet REST API の使用例を次に示します。

• セールスとアカウント管理

  • 記録のために会議と参加者の情報を取得します。
  • 会議のアーティファクトを取得して、アカウントに投稿します。
  • AI モデルで文字起こしと録音を実行して、コーチングと販売効率の分析を生成します。

• 学習と能力開発

  • トレーニング用の会議を作成して事前構成します。
  • トレーナーとセッション リーダーに共同主催者のロールを割り当てます。
  • コース終了後に生徒が教材を復習できるように、録画を取得します。

• カスタマー サポートとコンサルティング

  • ヘルプデスク チケットやクライアント ポータルから、安全で制限された会議スペースを直接作成できます。
  • サポート エージェントのみがプレゼンテーションを行ったり、出席者を管理したりできるように、主催者向けの管理機能を事前に構成します。
  • 品質保証とコンプライアンスの記録のために、自動録音または文字起こしを有効にします。
  • 予約またはサポート セッションが終了したときに、アクティブな会議をプログラムで終了します。

• デベロッパー オペレーション

  • 会議を作成して、チームメンバーとすぐに連絡を取り合うことができます。
  • リアルタイムの会議と参加者情報を共有して、他の関係者が進行中の会議に参加できるようにします。
  • 文字起こしデータを AI モデルで処理して、正しい次のステップを生成します。

図 1. Chat スペース内で同僚とダイナミックな会議を作成して参加できます。

また、Chat API などの他の Google Workspace API をアプリに組み込んで、コラボレーションをさらに強化することもできます。詳細については、Chat のユースケースをご覧ください。

注: Meet REST API は、ドメイン内のパフォーマンスの追跡やユーザーの評価を目的としたものではありません。この目的で Meet のデータを収集してはなりません。

よく使用する用語

この API で使用される一般的な用語を以下に示します。

アクティブな会議

会議スペース内で開催されている進行中の会議。会議スペースで一度に開催できるアクティブな会議は 1 つのみです。終了すると、履歴の会議記録になります。

アーティファクト

会議に応じて Meet によって生成されるファイル（recordings、transcripts、smartNotes など）。アーティファクトは会議の主催者の Google ドライブに保存されます。通常、会議の終了後すぐに取得できるようになります。

カレンダーの予定

複数の参加者がいる Google カレンダーの予定。通常は会議の主催者が作成し、会議の参加に必要な情報が含まれています。Meet は、イベントの会議ソリューションとして使用できます。

電話

Meet を使用するセッション、または通話が開始中または進行中であることを他のユーザーに通知し、すぐに参加できるようにします。

共同主催者

通話の参加者のうち、元の主催者を削除する権限を除き、主催者から主催者管理権限を付与されたユーザー。

会議

会議は、会議スペース内の通話のインスタンスです。通常、ユーザーはこのシナリオを 1 つの会議と見なします。

会議の記録

会議の各インスタンスの一意の ID。会議が開始されると、自動的に作成されます。conferenceRecords リソースは conferenceRecords/{conferenceRecord} 形式を使用します。例: conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ。

ダイヤルイン

スマートフォンを使用して通話に参加したり、ストリーミングされた通話を聞いたりする場合。

ホスト

通話を作成したユーザー（会議の主催者）または通話を制御するユーザー。会議の主催者は会議を主催できますが、会議の開催時に出席する必要はありません。主催者は、共同主催者に主催者の権限を委任することもできます。

会議コード

会議スペースの会議 URI 内で使用される、会議スペースの入力可能な一意の 10 文字の文字列。大文字と小文字は区別されません。例: abc-mnop-xyz。最大長は 128 文字です。

会議コードは会議スペースから関連付けが解除され、将来的に別の会議スペースで再利用される可能性があるため、長期的に保存しないでください。通常、会議コードは最後に使用されてから 365 日で有効期限切れになります。詳しくは、Google Meet の会議コードについての記事をご覧ください。

会議名

会議スペースの識別に使用される、サーバー生成の一意の ID。大文字と小文字は区別されます。例: jQCFfuBOdN5z会議 ID は spaces リソースの name フィールドに返されます。詳しくは、Meet で会議室を識別する方法をご覧ください。

会議の主催者

会議スペースを作成したユーザー。このユーザーは会議のオーナーと見なすこともできます。通話に参加していない場合や、会議の主催者でない場合があります。会議の主催者は 1 人のみです。

会議スペース

会議が開催される仮想の場所または永続オブジェクト（会議室など）。1 つのスペースで同時に開催できるアクティブな会議は 1 つのみです。会議用スペースは、ユーザーが会議に参加したり、共有リソースを見つけたりするのにも役立ちます。

会議 URI

ユーザーが通話を開始または参加するためのクリック可能な URL。各通話には、https://meet.google.com/ の後に会議コードが続く一意の URL があります。例: https://meet.google.com/abc-mnop-xyz

メンバー

指定されたロール（COHOST など）で会議スペースに明示的に追加されたユーザー。ライブ会議の開催中にのみ参加する参加者とは異なり、メンバーは永続的な会議スペースに関連付けられ、そのスペース内の複数の会議で権限を保持します。

参加者

通話に参加しているユーザー、コンパニオン モードを使用しているユーザー、視聴者として視聴しているユーザー、通話に接続されている会議室デバイス。ユーザーごとに 1 つの participants リソースがあります。参加者が会議に参加すると、一意の ID が割り当てられます。

参加者のセッション

通話に参加する参加者とデバイスのペアごとに作成される一意のセッション ID。セッションごとに 1 つの participantSessions リソースがあります。参加者が同じ通話に同じ参加者とデバイスのペアから複数回参加した場合、それぞれに一意のセッション ID が割り当てられます。

録画

会議の録画時に生成される MP4 動画ファイルと関連するメタデータ。録画は会議の主催者のドライブに保存され、会議のアーティファクトとして取得できます。

SIP アドレス

セッション開始プロトコル（SIP）アドレスは、サードパーティのビデオ会議ハードウェアが Meet の会議を見つけて参加する方法を詳しく説明します。Meet は SIP URI スキームをサポートしています。

スマートメモ

Gemini によって生成され、会議の主催者のドライブにドキュメント ファイルとしてエクスポートされた、会議の重要なポイントとアクション アイテムの簡潔な要約。

文字起こし

会議での会話をテキスト ドキュメントに記録し、会議の主催者の Google ドライブにドキュメント ファイルとしてエクスポートします。

文字起こしエントリ

会議の参加者の発話の文字起こしテキストの個別のセグメント。各エントリには、参加者の ID、タイムスタンプ、発言されたテキスト、言語コードが含まれており、会議の終了後 30 日間利用できます。

関連トピック

• 認証と認可の処理など、Google Workspace API を使用した開発の詳細については、Google Workspace での開発をご覧ください。

• Meet REST API を使用して会議室を作成する方法については、会議室を管理するガイドをご覧ください。

• Google Workspace イベントのサブスクライブ方法については、Google Workspace Events API を使用してイベントに登録するをご覧ください。