このガイドでは、Google Meet REST API を使用して Google Meet の会議を作成、管理する方法について説明します。
会議スペースは 、会議が開催される仮想の場所または永続的なオブジェクト（会議室など）を表します 。1 つのスペースで同時に開催できるアクティブな会議は 1 つだけです。会議スペースは、ユーザーが会議に参加して共有リソースを見つけるのにも役立ちます。
会議スペースを操作するには、会議スペースを作成、管理する をご覧ください。会議スペースを プログラムで構成する方法については、会議スペースと メンバーを構成するをご覧ください。
会議スペース メソッドを呼び出す方法
次の表に、会議スペース メソッドを使用するために必要な会議の役割を示します。
| メソッド | オーナー | 参加者 | その他 |
|---|---|---|---|
endActiveConference |
x | ||
get |
x | x | x |
| [設定] を使用 | x | ||
| アクティブな会議を使用 | x | x | |
patch |
x |
Meet が会議スペースを識別する方法
Google 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 に {meetingCode} を追加します: https://meet.google.com/tel/。例: 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.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 が入力され、リソース オブジェクトの一部として返されます。