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

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

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

#### <mark style="color:青;">QSS は、Zoom ダッシュボードと API で使用されるのと同じ基盤となる QoS メトリックを提供しますが、サンプリングとタイミングは異なります</mark>

既存の [Zoom ダッシュボード](https://support.zoom.us/hc/en-us/articles/204654719-Getting-started-using-the-Zoom-Dashboard-) は、ネットワークパフォーマンスと使用状況のメトリックを提供し、お客様の声がネットワーク環境で Zoom がどのように動作しているかを理解するのに役立ちます。QSS は同じ Zoom QoS データを提供しますが、より高速なレートです。このより高速なレートのサンプリングにより、集約された QoS メトリックはメインの Zoom ダッシュボードとは異なる値を表示する場合があります。ただし、これらのメトリックを設定することで、お客様の声は独自のダッシュボードビューに組み込み、Zoom データを追加のシステムと関連付けることができます。

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

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

#### <mark style="color:青;">Zoom Dashboardのデータは、QSSを介して顧客のサードパーティーのエンドポイントに配信されたデータと比較すべきではありません</mark>

QSSとZoom Dashboardは、Zoom QoSデータにアクセスするための2つの পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ পৃথ अलग পৃথ々の仕組みであり、比較すべきではありません。Zoom DashboardとQSSはいずれも同じQoSデータ群から取得しますが、取得タイミングとデータ配信頻度の違いにより、それぞれの仕組み内のデータは一致しません。

#### <mark style="color:青;">QSSは、Zoom Meetings、Webinars、Zoom Phoneの通話に対するリアルタイムのイベントデータをサポートします</mark>

QSSは、Zoom MeetingsとWebinars、およびZoom Phoneの通話について、アカウント内のすべてのユーザーに対するQoSイベントデータを提供します。Zoomは通話の最後の区間を管理しないため、QSSがZoom Phoneの通話に対して提供するのはアカウントレベルのQoSイベントデータのみであり、そのためエンドツーエンドの高度な参加者データを完全に可視化することはできません。

#### <mark style="color:青;">QSSのデータには外部参加者のデータは含まれません</mark>

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

### QSSを使用すると、お客様はZoom ダッシュボードの生のQoSデータを既存のワークフローに取り込むことができます

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

#### <mark style="color:青;">QSSは、ほぼリアルタイムのQoSイベントを購読済みのエンドポイントに配信し、APIポーリングとレート制限の影響を軽減します</mark>

QSSのお客様は、アプリケーションのエンドポイントにプッシュされるリアルタイムのQoSイベントとデータを購読できます。これにより、APIの定員を解放し、ネットワークの利用効率を最適化できます。QSSはZoomの [スタンダードwebhookサービスの拡張機能です](https://developers.zoom.us/docs/api/webhooks/) これは、エンドポイントに対して、分あたり4〜6回のほぼリアルタイムな速度で生のQoSデータを送信できるためです。

#### <mark style="color:青;">QSSを使用すると、お客様はAPIのレート制限に達することなく、Zoom ダッシュボードからほぼリアルタイムのQoSデータにアクセスできます</mark>

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

お客様の声が使用する [Zoom API](https://developers.zoom.us/docs/api/) Zoom ダッシュボードからQoSデータを取得するために使用すると、レート制限に達する場合があります。これは、一定時間内に実行できるAPIコールの最大数に達したことを意味します。QSSはAPIレート制限を増やしませんが、お客様自身がデータを取得する必要がないように、生のQoSデータをお客様のエンドポイントにプッシュすることで、お客様のレート制限に関する懸念を軽減します。

#### <mark style="color:青;">QSSにより、お客様は生のZoom QoSデータを利用し、好みのネットワーク管理システムを使用してトラブルシューティングを行うことができます</mark>

特定のお客様は、複数のアプリケーションにわたるネットワークパフォーマンスを同時に評価する必要がある場合があります。QSSにより、アプリケーション群内の他のデータと並べてダッシュボードでZoom QoSデータを監視できるため、柔軟でスケーラブルな方法でZoom QoSデータを利用し、カスタムダッシュボードにシームレスに統合できます。

#### <mark style="color:青;">Zoom QoSデータはTLS 1.2経由で送信されます</mark>

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

セキュリティをさらに強化するために、お客様は次を求められます [自分のWebhook エンドポイントを検証する](https://developers.zoom.us/docs/api/webhooks/) Challenge-Response Check（CRC）を使用して。CRCは、イベント 通知 エンドポイント URLの所有権とセキュリティを確認します。

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

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

お客様の声も追求できます。 [Zoom デベロッパー パック](https://news.zoom.com/zoom-announces-developer-pack-resale-for-channel-partners/) QSSフラグが有効になっており、QSSを他の開発者ツールと一緒にバンドルしています。

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

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

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

{% hint style="info" %}
この設定ではWebhookのみのアプリは必要ありません。Zoomでは一般アプリの作成を推奨しています。
{% endhint %}
{% endstep %}

{% step %}
**QSS Webhookイベントを購読する**

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

<figure><img src="/files/b5a06df2d981027aabeccd59e0f87788c897bafd" alt="Image of the Event types screen, focused on QSS options."><figcaption></figcaption></figure>

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

* `POST /marketplace/アプリ/イベント_subscription – 作成`
* `PATCH /{id} – ユーザー/アカウントを購読に追加`
* `DELETE /{id} – 登録解除/削除`
* `GET /マーケットプレイス/アプリ/イベント_subscription – 一覧`

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

{% step %}
**Webhook イベントを確認する**

イベント購読を設定した後は、Webhook URL の所有権とイベントの真正性の両方が適切に検証されていることを確認してください。

* **URL 検証**
  * イベント購読を最初に有効にすると、Zoom は Challenge–Response Check (CRC) を実行して、Webhook エンドポイントの所有権を確認します。このプロセスにより、Zoom がアプリによって管理されている正当な送信先にデータを送信していることが保証されます。(必要に応じて、CRC の処理をより前のセットアップ手順に含めることもできます。)
* **イベント検証**
  * 受信する各イベント通知は、アプリケーションによって検証され、Zoom から送信されたものであることを確認する必要があります。アプリは、各 Webhook イベントで提供される署名ヘッダーを使用して、受信リクエストを検証できます。デフォルトの署名方式以外の方法を好む開発者は、Zoom Developer Docs に記載されている他のサポートされている認証オプションのいずれかを使用できます。
  * Get Webhook Logs API を使用して、ステータス、再試行回数、トレース ID を含む最大 7 日分の Webhook 配信データを確認します。
    {% endstep %}
    {% endstepper %}

実装の詳細については、 [QSS 実装ガイド](https://drive.google.com/file/d/1oOEUeizi5VqtMTJIn3E1dFbYcbuv-Y2n/view) 開発者向け。技術的な詳細については、Zoom Developer Docs のイベント Subscription API、Webhook Logs API、および Client Credentials Grant 認証ガイドを参照してください。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://library.zoom.com/technical-library/ja/kn/network-management/quality-of-service-subscription-explainer.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.