Google Meet REST API の概要

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

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

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

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

ユースケース

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

  • 会議前: 会議スペースを作成して、必要に応じて会議エクスペリエンスをカスタマイズします。招待者を管理したり、設定を事前に構成したりすることもできます。

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

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

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

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

    • 記録用に会議と参加者に関する情報を取得します。
    • 会議アーティファクトを取得してアカウントに投稿します。
    • AI モデルを使用して音声文字変換と録音を実行し、コーチングと販売効果の分析を生成します。

  • 学習と能力開発

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

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

    • 会議を作成して、チームメイトとすぐにつながる。
    • 会議と参加者の情報をリアルタイムで共有して、進行中の会議に他のステークホルダーを招待できます。
    • AI モデルで音声文字変換データを実行して、正しい次のステップを生成します。
Chat スペース内でダイナミックな会議を作成して、同僚と参加する。
図 1. Chat スペース内で動的な会議を作成して、同僚と参加します。

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

よく使用する用語

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

アーティファクト
会議に応じて Meet によって生成されたファイル（録画や文字起こしなど）。通常、アーティファクトはカンファレンスの終了直後に取得できるようになります。
カレンダーの予定
複数の参加者がいる Google カレンダーの予定。通常は会議の主催者によって作成され、会議の参加情報が含まれます。Meet は、イベントの会議ソリューションになる可能性があります。
電話
Meet を使用したセッション、または通話の開始または進行状況を他のユーザーに通知して、すぐに参加できるようにする。
会議
会議は、会議スペース内の通話のインスタンスです。通常、ユーザーはこのシナリオを 1 つの会議と見なします。
共同ホスト
通話中のユーザーで、主催者から主催者管理権限を付与されている（元の主催者を削除する権限を除く）。
ホスト
通話を作成したユーザー（会議の主催者）または通話を管理しているユーザー。会議の主催者は会議を設定できますが、会議の開催時には参加する必要はありません。主催者は、主催者の権限を共同主催者に委任することもできます。
会議コード

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

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

会議名

会議スペースを識別するために使用される、サーバー生成の一意の ID。大文字と小文字が区別されます。例: jQCFfuBOdN5z会議 ID は、spaces リソースの name フィールドに返されます。

会議の主催者

ミーティング スペースを作成したユーザー。このユーザーは会議の所有者と見なすこともできます。通話中に不在の場合や、会議のホストでない場合があります。会議の主催者は 1 人だけです。

会議スペース

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

会議の URI

通話を開始または参加するためのクリック可能な URL。各呼び出しには、https://meet.google.com/ と会議コードで構成される一意の URL があります。例: https://meet.google.com/abc-mnop-xyz。

参加者

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

参加者のセッション

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