Google Meet REST API の概要

Google Meet REST API のイラスト

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

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

  • 会議スペースを作成します。
  • 会議室や会議をリソース名で取得する。
  • 参加者と参加者セッションのリストを取得します。
  • 会議のアーティファクト(録画、文字起こし、文字起こしのエントリ)を取得する。

この API で使用される一般的な用語は次のとおりです。

アーティファクト
会議への返信として Google Meet が生成したファイル(録画transcriptsなど)。通常、アーティファクトは会議の終了後すぐに取得できます。
カレンダーの予定
複数の参加者がいる Google カレンダーの予定。通常は会議の主催者が作成し、会議への参加情報が含まれます。Meet がイベントの会議ソリューションになるかもしれません。
電話
Meet を使用したセッション、または通話の開始または進行中を他のユーザーに通知してすぐに参加できるようにするセッション。
会議
会議とは、会議スペース内で行われる通話の 1 インスタンスです。ユーザーは通常、このシナリオを 1 回の会議と見なします。
ホスト
通話の作成者(会議の主催者)または通話を管理するユーザー。主催者は会議を主催できますが、主催者は会議に参加できません。主催者は、主催者の権限を共同主催者に委任することもできます。
会議コード
会議スペースの参加 URL 内で使用される、入力可能な一意の 10 文字の文字列。(例: abc-mnop-xyz)。会議コードは会議スペースから分離される可能性があり、将来的に別の会議スペースで再利用される可能性があるため、長期間保存しないでください。通常、会議コードの有効期限は最後に使用してから 365 日間です。詳しくは、Google Meet の会議コードについてをご覧ください。
会議名
会議スペースの識別に使用される、サーバーで生成された一意の ID。会議 ID は、spaces リソースの name フィールドで返されます。
会議の主催者
会議スペースを作成したユーザー。このユーザーは会議のオーナーになることもできます。通話中に存在しない場合や、会議の主催者ではない可能性があります。会議の主催者は 1 人のみです。
会議スペース
会議が開催される仮想の場所、または会議室などの永続的なオブジェクト。1 つのスペースで開催できる会議は 1 つのみです。会議スペースは、ユーザーが会議で共有リソースを見つけるのにも役立ちます。
参加者
通話に参加したユーザー、コンパニオン モードを使用しているユーザー、閲覧者として視聴しているユーザー、通話に接続されているルーム デバイス。ユーザーごとに 1 つの conferenceRecords.participants リソースがあります。参加者が会議に参加すると、一意の ID が割り当てられます。
参加者セッション
通話に参加する参加者とデバイスのペアごとに作成される一意のセッション ID。セッションごとに 1 つの conferenceRecords.participants.participantSessions リソースがあります。同じ参加者とデバイスのペアから同じ通話に複数回参加した参加者には、一意のセッション ID が割り当てられます。

API 固有の認可と認証情報

承認スコープは、アプリが会議コンテンツにアクセスすることをユーザーに承認するよう求める権限です。アプリをインストールすると、ユーザーはこれらのスコープを検証するように求められます。通常は、できるだけ限定されたスコープを選択し、アプリに不要なスコープをリクエストしないようにします。ユーザーは、明確に説明された制限付きのスコープに対して、アクセス権を付与しやすくなります。

Meet REST API は、次の OAuth 2.0 スコープをサポートしています。

スコープコード 説明 用途
https://www.googleapis.com/auth/meetings.space.readonly ユーザーがアクセスできるすべての会議スペースに関するメタデータの読み取りをアプリに許可します。 デリケートなコンテンツ
https://www.googleapis.com/auth/meetings.space.created アプリによって作成された会議スペースに関するメタデータの作成、変更、メタデータの読み取りをアプリに許可します。 デリケートなコンテンツ
https://www.googleapis.com/auth/drive.readonly Google Drive API から録音ファイルと文字起こしファイルをダウンロードすることをアプリに許可します。 制限されています

特定の OAuth 2.0 スコープの詳細については、Google API の OAuth 2.0 スコープをご覧ください。

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

  • Meet REST API を使用して会議スペースを作成する方法については、会議スペースの操作ガイドをご覧ください。