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 回の会議と見なします。
- 共同主催者
- ホストからホスト管理権限（元のホストを削除する権限を除く）が付与された呼び出しの参加者。
- ホスト
- 通話を作成したユーザー（会議の主催者）または通話を管理するユーザーです。主催者は会議を主催できますが、主催者は会議に参加できません。ホストは、ホストの権限を共同主催者に委任することもできます。
- 会議コード
- 会議スペースへの参加 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 を使用して会議スペースを作成する方法については、会議スペースの操作ガイドをご覧ください。
Google Workspace イベントに登録する方法については、Google Workspace Events API を使用してイベントに登録するをご覧ください。