> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/ja/kn/network-management/quality-of-service-subscription-explainer.md).

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

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

### クオリティオブサービスサブスクリプションは、イベントサブスクリプションを通じて、Zoom Meetings、ウェビナー、Zoom Phone のほぼリアルタイムの QoS テレメトリをストリーミングするアドオン製品です

Zoom のクオリティオブサービスサブスクリプション（QSS）は、Zoom Meetings、ウェビナー、電話通話のほぼリアルタイムのクオリティオブサービス（QoS）データを提供するアドオン製品です。QSS は、参加者単位の QoS イベントを1分間隔で送信することで、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>デバイス、ネットワーク、シグナリングリージョン、クライアントバージョン、オーディオ（入力／出力）、ビデオ（入力／出力）</td></tr><tr><td>頻度</td><td>参加者ごとに、約1分間に1件のイベント（アカウント設定に応じて、QoSメトリックごと、または集計されたセット単位）。</td></tr><tr><td>データ保持</td><td>イベント配信ログはWebhook Logs API経由で7日間保持されます。APIエンドポイント経由で取得できる過去のQoSデータは、より長期間保持される場合があります（ライセンスによって異なります）。</td></tr></tbody></table>

#### <mark style="color:青;">Zoomダッシュボードのデータと、QSSを介して顧客のサードパーティ製エンドポイントに配信されるデータは比較しないでください</mark>

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

#### <mark style="color:青;">QSSは、ミーティング、ウェビナー、電話のリアルタイムイベントデータに対応しています</mark>

QSSは、Zoom Meetingsおよびウェビナーのアカウント内のすべてのユーザーと、Zoom Phoneの通話について、QoSイベントデータを提供します。Zoomは通話の最終区間を管理しないため、QSSがZoom Phoneの通話について提供するのはアカウントレベルのQoSイベントデータのみです。そのため、参加者に関するエンドツーエンドの詳細データを完全に把握することはできません。

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

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/) を拡張したもので、1分あたり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/) には、チャレンジレスポンスチェック（CRC）を使用します。CRC により、イベント通知エンドポイントの URL の所有者とセキュリティを確認できます。

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

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

お客様の声は、さらに追求することもできます [Zoom Developer Pack](https://news.zoom.com/zoom-announces-developer-pack-resale-for-channel-partners/) QSS フラグを有効にすると、QSS がほかの開発者向けツールと一緒にバンドルされます。

{% stepper %}
{% step %}
**イベントサブスクリプションアプリ（一般またはサーバー間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="https://2994873379-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-0e6bcd7f34f9ebd6a9342919e58f15d0e72d51d0%2Fsubscribe-to-qss-webhook.png?alt=media" alt="Image of the Event types screen, focused on QSS options."><figcaption></figcaption></figure>

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

* `POST /marketplace/app/event_subscription – 作成`
* `PATCH /{id} – ユーザー/アカウントを登録する`
* `DELETE /{id} – 購読解除／削除`
* `GET /marketplace/app/event_subscription – 一覧`

API 経由で認証するには、クライアント認証情報グラントのトークンを使用します。
{% 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のEvent Subscription API、Webhook Logs API、およびClient Credentials Grant認証ガイドを参照してください。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
