Google Meet REST API の概要

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

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

  • 会議スペースを作成して、ユーザーをビデオで接続する。
  • リソース名で会議スペースまたは会議を取得する。
  • 参加者と参加者セッションのリストを取得する。
  • 会議のアーティファクト（録画、文字起こし、文字起こしエントリ）を取得する。

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

ユースケース

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

  • 会議前: 会議スペースを 作成して、必要に応じて会議のエクスペリエンスを調整します。招待者の管理や設定の事前構成も可能です。

  • 会議中: 会議情報を取得して、返されたメタデータに基づいてアプリの エクスペリエンスを変更します。

  • 会議後: 録画 や文字起こしなどの会議のアーティファクトを取得します。

Meet REST API の使用例をいくつかご紹介します。

  • 販売とアカウント管理

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

  • 学習と能力開発

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

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

    • 会議を作成してチームメンバーとすぐに接続する。
    • リアルタイムの会議と参加者の情報を共有して、他の関係者が進行中の会議に参加できるようにする。
    • AI モデルで文字起こしデータを実行して、正しい次のステップを生成する。
Chat スペース内で同僚とダイナミックな会議を作成して参加できます。
図 1.Chat スペース内で同僚とダイナミックな会議を作成して参加する。

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

よく使用する用語

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

アーティファクト
Meet が会議に応じて生成するファイル（ recordings や transcriptsなど）。 アーティファクトは会議の主催者の Google ドライブに保存されます。通常、会議が終了するとすぐに取得できるようになります。
カレンダーの予定
複数の参加者がいる Google カレンダーの予定。通常は 会議の主催者が作成し、会議の参加に必要な情報が含まれています。Meet は、予定の会議 ソリューションである可能性があります。
通話
Meet を使用するセッション。または、通話が開始または進行中であることを他のユーザーに通知し、すぐに参加できるようにします。
会議
会議は、会議スペース 内の通話 のインスタンスです。通常、ユーザーはこのシナリオを 1 つの会議と見なします。
会議レコード
会議 の各インスタンスの一意の ID。会議が開始されると自動的に作成されます。 conferenceRecords リソースは conferenceRecords/{conferenceRecord} という形式を使用します。例: conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ。
共同主催者
通話__に参加しているユーザーで、元の主催者を削除する機能を除き、主催者 __からホスト管理権限が付与されています。
ダイヤルイン
スマートフォンを使用して通話 に参加したり、ストリーミングされた通話を聴いたりすること。
ホスト
通話 を作成したユーザー（会議の主催者 ）または通話を管理するユーザー。会議の主催者は会議を主催できますが、会議の開催時に参加することはできません。ホストは、ホスト権限を共同主催者 に委任することもできます。
会議コード

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

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

会議名

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

会議の主催者

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

会議スペース

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

会議 URI

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

参加者

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

参加者セッション

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

SIP アドレス

Session Initiation Protocol（SIP）アドレスは、サードパーティのビデオ会議ハードウェアが Meet 会議を検索して参加する方法の詳細を示します。Meet は SIP URI スキームをサポートしています。