Meet eCDN On-Premises API を使用する

このページでは、Google Meet ライブストリーミングで Google Meet エンタープライズコンテンツ配信ネットワーク（eCDN）On-Premises API を使用する方法について説明します。

ここで説明する API ソリューションを使用すると、お客様はプライベート IP 情報を Google に公開することなく、Meet eCDN のすべての機能を使用できます。プライベート IP アドレス情報の代わりに ID を渡す、新しいオンプレミスウェブサービスを独自のネットワークで定義できます。

Meet eCDN の概要

eCDN は Meet に組み込まれており、Google Workspace 管理者が設定すると、ライブストリーミング中に自動的に開始されます。Meet eCDN を有効にすると、ローカルネットワーク内のライブストリーミング視聴者は、ピアツーピア（P2P）共有を通じて、ライブストリーミングメディアをネットワーク内の他のピアと共有できます。ほとんどのデバイスは、近くのピアからライブストリーミングメディアを受信するため、Google のサーバーから取得する必要はありません。これにより、視聴者が使用する合計帯域幅が削減されます。Meet eCDN の設定と使用について詳しくは、大規模なライブストリーミングをホストするをご覧ください。

eCDN では、Meet ライブストリーミングの視聴者をピアリンググループに分類する必要があります。ピアリンググループは、メディアを相互に共有できるノードの集まりです。ピアリンググループ内のデバイスは、ピアリングが許可されるか、ピアリングがブロックされます。許可されたデバイスは、同じピアリンググループ内の他のデバイスにのみ接続できます。ピアリンググループについて詳しくは、大規模なライブストリーミングをホストする前にをご覧ください。

API を使用するケース

eCDN は、random、subnet、custom rules など、いくつかの異なるピアリングポリシーを使用してピアリンググループを形成できます。後者は、各ピアノードのプライベート IP アドレスをピアリンググループにマッピングするために、プライベートネットワーク範囲のテーブルを Google の eCDN トラッカーサーバーと共有します。custom rules ポリシーは推奨されるソリューションであり、ほとんどの本番環境に適しています。

ただし、custom rules ポリシーでは、プライベートネットワーク構造の大部分を Google と共有する必要があります。また、個々のユーザーは、eCDN の使用中にローカルで検出されたプライベート IP アドレスを Google に公開します。組織によっては、セキュリティガイドラインでプライベート IP 情報の共有が許可されない場合があります。

Meet eCDN On-Premises API を使用して開発する

Meet eCDN On-Premises API は、組織のネットワークにローカルで実装してホストできるウェブサーバー仕様を提供します。API と互換性のあるカスタムウェブサービスを構築して、プライベート IP 情報に依存するすべてのタスクを実行できるため、情報は Google と共有されません。

この API は、通常 eCDN トラッカーサーバーによって処理される、プライベート IP アドレスのマッチングの 2 つの重要なステップを包含しています。プライベート IP アドレスをピアリンググループにマッピングすることと、Session Description Protocol （SDP）のオファーとアンサーのデータ交換です。

ウェブサービスが完成したら、管理コンソールをOn-premises serviceピアリングポリシーを使用するように構成し、カスタムウェブサービスの URL を含める必要があります。

要件

組織でこれらの要件を有効にする必要がある場合は、Google Workspace 管理者にお問い合わせください。

HTTPS を使用するウェブサーバーであれば、この API を実装できます。
混合コンテンツのエラーを防ぐには、HTTPS を使用します。
JSON データを受け入れて返します。ブラウザでサポートされているコンテンツエンコードを使用します。
/vn ルートでエンドポイントを提供します。ここで n は選択した API バージョンです。例: /v1/get-peering-group
Meet ライブストリーミングの視聴者は、Google 管理コンソールでウェブサービスの URL を確認できます。URL は、組織全体、組織部門ごと、またはグループごとに設定できます。視聴者が割り当てられたサービスのインスタンスに接続できることを確認してください。詳しくは、管理コンソールを構成するをご覧ください。
サービスは 2 秒以内にレスポンスを返す必要があります。そうしないと、eCDN クライアントがシャットダウンし、視聴者は通常の eCDN 以外のユーザーとしてライブイベントを視聴し続けるため、帯域幅を節約できません。
サービスは、次のクロスオリジンリソースシェアリング（CORS）ヘッダーを設定する必要があります。
- Access-Control-Allow-Origin: meet.google.com
- Access-Control-Allow-Headers: GET, POST, OPTIONS
- Access-Control-Allow-Credentials: true

プライベート IP アドレスをピアリンググループにマッピングする

eCDN クライアントは、eCDN トラッカーサーバーに再接続しようとするたびに呼び出しを行います。デバイスがプライベート IP アドレスを検出したら、そのアドレスを適切なピアリンググループにマッピングする必要があります。プライベート IP アドレスをネットワーク上のサーバーに送信し、get-peering-group() メソッドを使用してピアリンググループに手動で解決する必要があります。レスポンスでピアリンググループ ID が返されます。 Google と通信する場合、プライベート IP アドレスの代わりに、結果のピアリンググループ ID が渡されます。

プライベート IP アドレスがピアリンググループにマッピングされる方法。 — **図 1.**プライベート IP アドレスをピアリンググループにマッピングする。

次のコードサンプルは、get-peering-group() メソッドの呼び出し方法と、考えられるエラーレスポンス、想定されるレスポンス本文を示しています。

POST /v1/get-peering-group
Content-Type: application/json

Request body:
{
  "availableIPs": []{
    "format": "ipv4"|"ipv6",
    "address": "DETECTED_ADDRESS"
  }
}

Error response:
{
  "result": null,
  "error": "ERROR_MESSAGE"
}

Response body:
{
  "allowed": boolean,
  "result": string,
  "error": null
}

次の表に、想定されるレスポンス形式を示します。

HTTP ステータス	エラー	許可	結果	クライアントの反応
200	null	true	空でない文字列	クライアントは指定されたピアリンググループに分類され、eCDN トラッカーサーバーへの接続に進みます。
200	null	false	空でない文字列	クライアントは指定されたピアリンググループによってブロックされたものとしてマークされ、Meet 品質管理ツール（MQT）に表示され、eCDN セッションを終了します。
200	null		空の文字列	クライアントは eCDN セッションを終了します。
200	空でない文字列			クライアントは eCDN セッションを終了します。
302（検出）				クライアントは、レスポンス本文の `Location` ヘッダーで指定された新しい URL にリダイレクトされます。
その他のステータスコード				クライアントは eCDN セッションを終了します。

従来のレスポンス形式

allowed フィールドは、以前のバージョンのレスポンス形式には含まれていませんでした。代わりに、result の特別な予約値によって、視聴者の IP アドレスがピアリングからブロックされるかどうかが決まります。

Legacy response body:
{
  "result": string,
  "error": null,
}

レスポンスメッセージで allowed フィールドが設定されていない場合の想定されるレスポンス形式を次の表に示します。

HTTP ステータス	エラー	結果	クライアントの反応
200	null	空でない文字列	クライアントはピアリンググループに分類され、eCDN トラッカーサーバーへの接続に進みます。
200	null	`NOT_FOUND`	クライアントは eCDN セッションを終了します。
200	null	`BLOCKED`	クライアントは eCDN セッションを終了します。
200	空でない文字列		クライアントは eCDN セッションを終了します。
302（検出）			クライアントは、レスポンス本文の `Location` ヘッダーで指定された新しい URL にリダイレクトされます。
その他のステータスコード			クライアントは eCDN セッションを終了します。

SDP のオファーとアンサーのデータ交換

WebRTC 接続を開始するには、デバイスはプライベート IP 情報を含む SDP のオファーとアンサー（Interactive Connectivity Establishment（ICE）候補を含む）を交換する必要があります。これは、WebRTC シグナリングプロセスの一部として行われます。

クライアントは、Meet eCDN On-Premises API を使用して、ネットワーク内の ICE 候補を encrypt-sdp() メソッドで暗号化する必要があります。このメソッドは、Google に公開されない鍵を使用します。暗号化された SDP オファーは、eCDN トラッカーサーバーを使用してピアに送信されます。クライアントピアは、decrypt-sdp() メソッドを使用して、受信した情報をネットワーク内で復号します。その後、Google は接続されたピア間でオファーとアンサーを転送します。

Meet eCDN On-Premises API を使用して接続が確立されると、eCDN は通常どおり動作します。ピアは通常のピアリングネットワークを介してメディアをルーティングし、メディアトラフィックは API を通過したり使用したりしません。

SDP オファーとアンサーのデータの暗号化と復号の方法。 — **図 2.**SDP のオファーとアンサーのデータを暗号化および復号する。

次のコードサンプルは、encrypt-sdp() メソッドの呼び出し方法と、考えられるエラーレスポンス、想定されるレスポンス本文を示しています。

POST /v1/encrypt-sdp
Content-Type: application/json

Request body:
{
  "data": "SDP_DATA"
},

Error response:
{
  "result": null,
  "error": "ERROR_MESSAGE"
}

Response body:
{
  "result": "ENCRYPTED_DATA_STRING",
  "error": null
}

次のコードサンプルは、decrypt-sdp() メソッドの呼び出し方法と、考えられるエラーレスポンス、想定されるレスポンス本文を示しています。

POST /v1/decrypt-sdp
Content-Type: application/json

Request body:
{
  "data": "ENCRYPTED_DATA_STRING"
},

Error response:
{
  "result": null,
  "error": "ERROR_MESSAGE"
}

Response body:
{
  "result": "SDP_DATA",
  "error": null
}

次の表に、想定されるレスポンス形式を示します。

HTTP ステータス	エラー	ピアリンググループ ID	クライアントの反応
200	null	空でない文字列	クライアントは、適切にエンコードまたはデコードされた SDP データが使用されることを想定しています。
200	空でない文字列	null	クライアントは eCDN セッションを終了します。
302（検出）			クライアントは、レスポンス本文の `Location` ヘッダーで指定された新しい URL にリダイレクトされます。
その他のステータスコード	任意の値	任意の値	クライアントは eCDN セッションを終了します。

管理コンソールを構成する

Meet eCDN On-Premises API を使用するには、管理コンソールで eCDN を構成して、カスタムウェブサービスの URL を含める必要があります。

eCDN を設定するには、On-premises service を使用してピアリングポリシーを作成し、IP 情報をピアリンググループに手動で照合します。デフォルトの 443 を使用していない場合は、ポート番号を含めることもできます。URL は WEB_SERVICE.example.com:8080 の形式にする必要があります。ここで、WEB_SERVICE はウェブサービス名です。

ピアリングポリシーの設定について詳しくは、ネットワークグループを構成するをご覧ください。

Meet eCDN の使用方法については、大規模なライブストリーミングをホストするの手順に沿って操作してください。
eCDN の設定方法については、大規模なライブストリーミングをホストする前にをご覧ください。
ネットワークの設定方法については、Meet の会議とライブ配信用にネットワークを準備するをご覧ください。
管理者として Google 管理コンソールにログインするには、管理コンソールにログインするをご覧ください。

Meet eCDN On-Premises API を使用する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。