このガイドでは、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（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.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 が入力され、リソース オブジェクトの一部として返されます。