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 API などの他の Google Workspace API をアプリに組み込んで、コラボレーションをさらに進めることもできます。詳細については、 チャットのユースケースをご覧ください。
よく使用する用語
この API で使用される一般的な用語は次のとおりです。
- アーティファクト
- 会議に応じて Meet によって生成されるファイル(録画やtranscriptsなど)。通常、会議が終了するとすぐにアーティファクトを取得できるようになります。
- カレンダーの予定
- 複数の参加者がいる Google カレンダーの予定。通常は会議の主催者が作成し、会議の参加情報を含めます。Meet をイベントの会議ソリューションとして利用することが考えられます。
- 電話
- Meet を使用したセッション、または通話が開始または進行中であることを他のユーザーに通知して、すぐに参加できるようにする。
- 会議
- 会議とは、会議スペース内で行われる通話のインスタンスです。通常、ユーザーはこのシナリオを 1 回の会議と見なします。
- 共同主催者
- ホストからホスト管理権限が付与された通話に参加しているユーザー(元のホストを削除する権限を除く)。
- ホスト
- 通話を作成したユーザー(会議の主催者)または通話を管理するユーザー。主催者は会議を開催できますが 主催者は参加できませんホストは、ホスト権限を共同主催者に委任することもできます。
- 会議コード
会議スペース用の入力可能な一意の 10 文字の文字列。会議スペースの会議 URI の中で使用されます。大文字と小文字は区別されません。例:
abc-mnop-xyz
。最大長は 128 文字です。会議コードは会議スペースから切り離され、将来的に別の会議スペースで再利用される可能性があるため、長期間保存しないでください。通常、会議コードの有効期限は最後に使用されてから 365 日間です。詳しくは、Google Meet の会議コードの詳細をご覧ください。
- 会議名
サーバーが生成し、会議スペースの識別に使用される一意の ID。大文字と小文字が区別されます。たとえば、
jQCFfuBOdN5z
のようにします。会議 ID は、spaces
リソースのname
フィールドに返されます。- 会議の主催者
会議スペースを作成したユーザー。このユーザーは会議の主催者を 指名することもできます相手が通話中にいない場合、または会議の主催者ではない可能性があります。会議の主催者は 1 人のみです。
- 会議スペース
会議が開催される仮想の場所または永続的なオブジェクト(会議室など)。1 つのスペースで開催できるアクティブな会議は一度に 1 つのみです。会議スペースは、ユーザーが集まって共有リソースを見つけるのにも役立ちます。
- 会議の URI
通話を開始したり、通話に参加したりするクリック可能な URL。各通話には一意の URL があり、
https://meet.google.com/
の後に会議コードが続きます。例:https://meet.google.com/abc-mnop-xyz
。- 参加者
通話に参加しているユーザー、コンパニオン モードを使用して視聴しているユーザー、または通話に接続されているルームデバイスとして視聴しているユーザー。
conferenceRecords.participants
リソースはユーザーごとに 1 つあります。参加者が会議に参加すると、一意の 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 を使用して会議スペースを作成する方法については、会議スペースを操作するをご覧ください。
Google Workspace のイベントに登録する方法については、Google Workspace Events API を使用してイベントに登録するをご覧ください。