クオリティオブサービスサブスクリプションの解説

クオリティオブサービスサブスクリプションは、ミーティング、ウェビナー、およびPhoneのQoSデータをお客様のサードパーティ製エンドポイントに提供するアドオン製品です。

クオリティオブサービスサブスクリプションは、イベントサブスクリプションを介して、Zoom Meetings、Webinars、Zoom Phone向けのほぼリアルタイムのQoSテレメトリをストリーミングするアドオン製品です

Zoomのクオリティオブサービスサブスクリプション（QSS）は、Zoom Meetings、Webinars、および電話通話向けに、ほぼリアルタイムのクオリティオブサービス（QoS）データを提供するアドオン製品です。QSSは、参加者レベルのQoSイベントを分単位の間隔で送信することにより、Zoomの製品機能を拡張します（レートと集約は構成によって異なる場合があります）。お客様の声は、この豊富なデータストリームを使用して、ネットワーク環境がZoomのサービスに影響しているかどうかを特定できます。

QSSは、Zoom ダッシュボードおよびAPIで使用されるものと同じ基盤となるQoSメトリクスを提供しますが、サンプリングとタイミングは異なります

既存の Zoom ダッシュボード は、ネットワークパフォーマンスと使用状況のメトリクスを提供し、お客様がネットワーク環境でZoomがどのように動作しているかを理解するのに役立ちます。QSSは同じZoom QoSデータを提供しますが、より高速なレートです。この高速なレートのサンプリングにより、集約されたQoSメトリクスはメインのZoom ダッシュボードとは異なる値を表示します。ただし、これらのメトリクスにより、お客様はそれらを独自のダッシュボードビューに設定することができ、Zoomデータを追加のシステムと関連付けることができます。

以下の表は、QSSを介して顧客のエンドポイントに配信されるQoSデータについて説明しています。

	QSS経由で配信されるQoSデータ
品質メトリクス	ビットレート、遅延、ジッター、パケット損失、解像度、フレームレート、CPU使用率
使用メトリクス	デバイス、ネットワーク、シグナリングリージョン、クライアントバージョン、オーディオ（I/O）、ビデオ（I/O）
頻度	約1イベント／分、参加者ごと（アカウント設定に応じて、各QoSメトリックごとまたは集計セットごと）。
データ保持	イベント配信ログは Webhook Logs API を通じて7日間保持されます。履歴QoSデータは API エンドポイント を通じてより長く保持される場合があります（ライセンスによる）。

Zoom ダッシュボードのデータは、QSS を通じて顧客のサードパーティ エンドポイントに配信されたデータと比較すべきではありません

QSS と Zoom ダッシュボード は、比較すべきではない Zoom QoS データへのアクセスのための2つの別個の仕組みを提供します。Zoom ダッシュボード と QSS は同じQoSデータのプールから取得しますが、取得タイミングとデータ配信頻度の違いにより、各仕組みのデータは一致しません。

QSS は、ミーティング、ウェビナー、Zoom Phone の通話に対するリアルタイムのイベントデータをサポートします

QSS は、Zoom Meetings と Zoom Webinars、ならびに Zoom Phone の通話について、アカウント上のすべてのユーザー向けのQoSイベントデータを提供します。Zoom は通話の最終区間を管理していないため、QSS は Zoom Phone の通話についてアカウントレベルのQoSイベントデータのみを提供し、そのためエンドツーエンドの詳細な参加者データを完全には可視化できません。

QSSデータには外部参加者のデータは含まれません

QSSは外部のミーティング参加者のデータを提供しません。ただし、QSSは、どの社内ミーティング参加者に問題があったのか、その問題が何だったのか、さらにお客様の声が問題のトラブルシューティングに必要とする品質および使用状況のメトリクスを特定するのに役立ちます。

QSSにより、お客様の声はZoom ダッシュボードの生のQoSデータを既存のワークフローに取り込めます

これまでZoomのお客様の声は、Zoom ダッシュボードやAPIなどのツールを使用してZoom QoSデータを表示または取得できましたが、QSSを使うと、イベント購読（webhookまたはWebSocket）を介してZoom QoSテレメトリをネットワーク管理および監視プラットフォームにストリーミングできます。

QSSは、購読済みのエンドポイントにほぼリアルタイムのQoSイベントを配信し、APIポーリングとレート制限の影響を軽減します

QSSのお客様の声は、アプリケーションのエンドポイントにプッシュされるリアルタイムのQoSイベントとデータを購読できるため、APIの定員を解放し、ネットワーク利用率を最適化するのに役立ちます。QSSは、Zoomの スタンダード webhook サービスの拡張機能です これは、エンドポイントにほぼリアルタイムの速度で、1分あたり4～6回、生のQoSデータを送信できるためです。

QSSにより、お客様の声はAPIのレート制限に達することなく、Zoom ダッシュボードからほぼリアルタイムのQoSデータにアクセスできます

APIサービスはリクエストベースであり、アプリまたはユーザーから要求されたデータを収集するために「プル」メカニズムを使用します。APIは、APIエンドポイントからデータを取得するために繰り返し呼び出しが必要なため、webhookよりも多くのリソースを消費します。

ZoomのAPIを使用するお客様の声は Zoom API ZoomダッシュボードからQoSデータを取得しようとすると、レート制限に達する場合があります。これは、一定期間内に実行できるAPI呼び出しの最大数に達したことを意味します。QSSはAPIのレート制限を引き上げることはありませんが、データを自分で取得する必要がなく、未加工のQoSデータをエンドポイントに送信することで、お客様の声のレート制限に関する懸念を軽減します。

QSSにより、お客様の声は未加工のZoom QoSデータを利用し、好みのネットワーク管理システムを使ってトラブルシューティングできます

一部のお客様の声は、複数のアプリケーションにわたるネットワークパフォーマンスを同時に評価する必要がある場合があります。QSSを使用すると、Zoom QoSデータをアプリケーションスイート内の他のデータと並べてダッシュボードで監視でき、Zoom QoSデータを柔軟かつ拡張性の高い方法で利用し、カスタムダッシュボードにシームレスに統合できます。

Zoom QoSデータはTLS 1.2で送信されます

QSSデータはTLS 1.2以上を使用して転送中に暗号化されます。エンドポイントは有効な証明書認証局（CA）証明書を使用する必要があります。Webhookリクエストには、認証のための署名ヘッダーとチャレンジレスポンスチェックが含まれます。

追加のセキュリティのため、お客様の声は次の操作を求められます Webhookエンドポイントを検証する チャレンジレスポンスチェック（CRC）を使用します。CRCは、イベント通知エンドポイントURLの所有権とセキュリティを確認します。

お客様の声は、QSSイベントを受信できるアプリケーションを作成することで、QoSデータの利用を開始できます

お客様が QSS アドオン プランを購入した後、アカウント上の少なくとも 1 人のユーザーで開発者権限を有効にする必要があります。お客様の声は、次の 3 つの手順を使用して、QSS イベントを購読できる Webhook アプリケーションを作成できます。

お客様の声はまた、追求することができます Zoom 開発者向けパック QSS フラグが有効になっており、QSS を他の開発者向けツールとまとめています。

1

イベントサブスクリプション アプリ（General または Server-to-Server OAuth）を作成します。イベントサブスクリプションを有効にし、QoS イベントを選択します

お客様の声は、まず General または Server-to-Server OAuth アプリを作成する必要があります。 Zoom App Marketplace。その後、イベントサブスクリプションを有効にし、受信したいQoSイベントを選択します。

次へ、お客様の声は、アプリケーションのイベント通知エンドポイントURLを入力して、QSSイベント通知の送信先を指定する必要があります

この構成ではWebhook専用アプリは必要ありません。Zoomでは、一般アプリを作成することを推奨しています。

2

QSS Webhook イベントを購読する

QSSイベントを購読するには、お客様の声はイベントを追加し、オンラインのQSSの一覧から選択する必要があります イベントの種類. お客様の声は、プロセスを完了してアプリケーションを有効化する前に、1つ以上のQSSイベントを選択できます。

Marketplace UI または API 呼び出しを使用して、サブスクリプションを管理することもできます。

• POST /marketplace/アプリ/イベント_subscription – 作成

• PATCH /{id} – ユーザー/アカウントを購読登録する

• DELETE /{id} – 登録解除/削除

• GET /marketplace/アプリ/イベント_subscription – 一覧

API経由で認証するには、Client Credentials Grantのトークンを使用します。

3

Webhookイベントを検証する

イベントサブスクリプションを構成した後は、Webhook URLの所有権とイベントの真正性の両方が適切に検証されていることを確認してください。

• URLの検証

  • イベントサブスクリプションを最初に有効にすると、ZoomはChallenge–Response Check (CRC) を実行して、Webhookエンドポイントの所有権を確認します。このプロセスにより、Zoomがアプリによって管理されている正当な送信先にデータを送信していることが保証されます。（必要に応じて、CRCの処理を以前のセットアップ手順に含めることもできます。）

• イベントの検証

  • 受信した各イベント通知は、アプリケーションによって検証され、Zoomから送信されたものであることを確認する必要があります。アプリは、各Webhookイベントで提供される署名ヘッダーを使用して受信リクエストを検証できます。デフォルトの署名方式の代替を希望する開発者は、Zoom Developer Docsに記載されている他のサポートされている認証オプションのいずれかを使用できます。

  • Get Webhook Logs APIを使用して、ステータス、再試行回数、トレースIDを含む最大7日分のWebhook配信データを確認します。

完全な実装の詳細については、 QSS Implementation Guide 開発者向け。技術的な詳細については、Zoom Developer Docs のイベント サブスクリプション API、Webhook Logs API、および Client Credentials Grant 認証ガイドを参照してください。