このガイドでは、Google Meet REST API を使用して Google Meet の会議を作成および管理する方法について説明します。
ミーティング スペースは、会議が開催される仮想の場所または永続オブジェクト（会議室など）を表します。1 つのスペースで同時に開催できるアクティブな会議は 1 つだけです。会議用スペースは、ユーザーが会議に参加したり、共有リソースを見つけたりするのにも役立ちます。
会議室を操作するには、会議室を管理するをご覧ください。会議室をプログラムで構成する方法については、会議室の設定を構成するをご覧ください。会議スペースのメンバーを管理するには、会議スペースのメンバーを管理するをご覧ください。
会議スペース メソッドの権限
次の比較表に、会議スペース メソッドを使用するために必要な会議の役割を示します。
| メソッド | オーナー | 参加者 | その他 |
|---|---|---|---|
endActiveConference |
|||
get |
|||
| 設定あり | |||
| アクティブな会議がある場合 | |||
patch |
Meet が会議スペースを識別する方法
Meet REST API は、会議スペースごとに spaces リソースを生成します。spaces リソースには、会議に参加するための複数のエントリ ポイントが用意されています。
次の表に、ミーティング スペースを特定して参加する方法を示します。
| フィールド名 | 説明 |
|---|---|
name |
スペースの名前。{space} 文字列は、スペースのリソース識別子で、spaces/{space} の形式で指定します。これはサーバーによって生成される一意の ID であり、大文字と小文字が区別されます。例: spaces/jQCFfuBOdN5z。 |
meetingCode |
スペース名のエイリアス。{meetingCode} は入力可能な一意の文字列で、大文字と小文字は区別されません。形式は spaces/{meetingCode} です。たとえば、spaces/abc-mnop-xyz のようにします。最大長は 128 文字です。meetingUri の一部を構成します。
https://meet.google.com/abc-mnop-xyz。 |
phoneAccess |
この会議スペースの電話アクセス方法。phoneAccess オブジェクトには、会議室の地域の電話番号やその電話番号に固有の PIN コードなど、会議にダイヤルインするために必要な情報が含まれています。PIN は 10 進数の数字のみで構成され、長さは異なる場合があります。例: "pin": 19707127300。Meet の UI と同様に、 spaces リソースには限定されたセットのダイヤルイン番号が含まれます。会議スペースの電話番号を追加で確認するには、次の URL（https://meet.google.com/tel/）に {meetingCode} を追加します。例: https://meet.google.com/tel/abc-mnop-xyz |
gatewaySipAccess |
この会議スペースのセッション開始プロトコル（SIP）アクセス方法。SIP アドレスは、サードパーティのビデオ会議ハードウェアが Meet 会議を見つけて参加する方法の詳細を示します。gatewaySipAccess オブジェクトには、URI と数値のアクセスコードが含まれます。Meet は SIP URI スキームをサポートしています。 |
会議スペースを管理するには、name フィールドに次の値を使用します。
会議スペースの詳細を取得するには、
spaces/{space}またはエイリアスspaces/{meetingCode}を使用します。詳しくは、会議室を予約するをご覧ください。会議スペースの詳細を更新するには、
spaces/{space}のみを使用できます。詳細については、会議スペースを更新するをご覧ください。会議スペース内でアクティブな会議を終了するには、
spaces/{space}のみを使用できます。詳しくは、アクティブな会議を終了するをご覧ください。会議スペースのメンバーを管理するには、
spaces/{space}のみを使用できます。エイリアス{meetingCode}はサポートされていません。詳細については、会議スペースのメンバーを管理するをご覧ください。
ユースケース別の OAuth スコープ
Meet での認証ガイドには、すべての Meet REST API スコープとその検証の機密性レベルが一覧表示されています。ただし、会議スペースを操作する場合、スペースがアプリによって作成されたか、外部アプリ（Google カレンダーなど）によって作成されたかによって、スコープの要件が異なります。
次の表に、特定の会議スペースのユースケースに基づく必要な OAuth スコープを示します。
| ユースケース | スコープ コード |
|---|---|
| 他のアプリによって作成されたスペースの自動アーティファクト生成を設定します。 | https://www.googleapis.com/auth/meetings.space.settings |
| 他のアプリで作成された会議のアーティファクトを取得または一覧表示します。 | https://www.googleapis.com/auth/meetings.space.readonly |
| サードパーティ製アプリによって作成された会議スペースの会議前の他の設定を取得または一覧表示します。 | https://www.googleapis.com/auth/meetings.space.createdhttps://www.googleapis.com/auth/meetings.space.readonly |
| ユーザーがカレンダーなどの他のアプリからアクセスできるすべての会議スペースの設定を読み取り、編集します。 | https://www.googleapis.com/auth/meetings.space.settings |
サポートされているすべてのスコープと承認の機密性レベルの完全なリストについては、Meet REST API スコープをご覧ください。
会議室のライフサイクル
会議スペースは、ライフサイクル中にいくつかの状態を経ます。次の図は、会議スペースのライフサイクルの概要を示しています。
電話
spaces.create。 会議スペースが作成され、返されたspacesオブジェクトにmeetingUri文字列が含まれます。その後、meetingUriが参加者に配信されます。会議の開始前に、会議スペースの設定を構成したり、会議スペースのメンバーを管理したりできます。新しい会議スペースのアンケートを実施します。
spaces.getメソッドを呼び出して、会議の状態を確認します。ポーリングの代わりに、Meet イベントを購読してプッシュ通知を受け取ることもできます。
会議を開始します。会議スペース内の
meetingUriを最初の参加者がクリックすると、会議が開始されます。activeConferenceオブジェクトにデータが入力され、activeConference.conferenceRecord文字列が設定されます。（省略可）会議データを取得します。会議がアクティブな間、一部の
conferenceRecord値にアクセスできます。たとえば、conferenceRecords.participants.listメソッドを呼び出して、会議のすべての参加者を確認します。この情報には、会議後 30 日間アクセスすることもできます。（省略可）会議を終了します。会議中に、会議の所有者は
spaces.endActiveConferenceメソッドを呼び出して、すべて参加者のアクティブな会議をプログラムで終了できます。会議が終了します。最後の参加者が退出すると、会議は終了します。
会議後のアーティファクトをポーリングします。会議は終了しましたが（
STATE=ENDED）、アーティファクトはまだ生成されていません。会議のstartTimeとendTimeも入力されます。アーティファクト オブジェクトSTATEがFILE_GENERATEDを読み取るまで、アーティファクト エンドポイントをポーリングする必要があります。ポーリングの代わりに、Meet イベントに登録してプッシュ通知を受け取ることができます。
会議後のアーティファクトを取得する。録音、文字起こし、スマートメモなどのアーティファクトは、生成後に取得できます。たとえば、
conferenceRecords.recordings.getメソッドを呼び出して、録音 ID で録音を取得します。準備が整うと、アーティファクト オブジェクトの URI が入力され、リソース オブジェクトの一部として返されます。