> 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). # クオリティオブサービスサブスクリプションの解説 クオリティオブサービスサブスクリプションは、ミーティング、ウェビナー、およびPhone QoSデータを顧客のサードパーティのエンドポイントに提供するアドオン製品です。 ### クオリティオブサービスサブスクリプションは、イベントサブスクリプションを通じて、Zoom Meetings、Webinars、Zoom PhoneのほぼリアルタイムのQoSテレメトリをストリーミングするアドオン製品です Zoomのクオリティオブサービスサブスクリプション（QSS）は、Zoom Meetings、Webinars、Phone通話向けにほぼリアルタイムのクオリティオブサービス（QoS）データを提供するアドオン製品です。QSSは、分単位の間隔で参加者レベルのQoSイベントを送信することでZoomの製品機能を拡張します（レートと集計は設定によって異なる場合があります）。お客様の声は、この豊富なデータストリームを使用して、ネットワーク環境がZoomのサービスに影響を与えているかどうかを特定できます。 #### QSSは、Zoom ダッシュボードおよびAPIで使用されるものと同じ基盤となるQoS指標を提供しますが、サンプリングとタイミングは異なります 既存の [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データについて説明しています。
QSSを介して配信されるQoSデータ
品質指標ビットレート、レイテンシー、ジッター、パケット損失、解像度、フレームレート、CPU使用率
使用状況指標デバイス、ネットワーク、シグナリングリージョン、クライアントバージョン、オーディオ（I/O）、ビデオ（I/O）
頻度参加者ごとに1分あたり約1イベント（アカウント設定に応じて、QoS指標ごとまたは集計セットごと）。
データ保持イベント配信ログはWebhook Logs APIを通じて7日間保持されます。APIエンドポイントを介した履歴QoSデータは、より長く保持される場合があります（ライセンスに応じて）。
#### Zoom ダッシュボードのデータを、QSSを介してお客様の声のサードパーティエンドポイントに配信されるデータと比較しないでください QSSとZoom ダッシュボードは、比較すべきではないZoom QoSデータにアクセスするための2つの別個の仕組みを提供します。Zoom ダッシュボードとQSSは同じQoSデータプールから取得しますが、データ取得のタイミングと配信頻度の違いにより、それぞれの仕組みのデータは一致しません。 #### QSSは、Meetings、Webinars、およびPhone通話のリアルタイムイベントデータをサポートします QSSは、Zoom Meetingsおよび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サービス](https://developers.zoom.us/docs/api/webhooks/) これは、ほぼリアルタイムのレートで1分あたり4～6回、生QoSデータをエンドポイントに送信できるためです。 #### QSSにより、お客様の声はAPIレート制限に達することなく、Zoom ダッシュボードからほぼリアルタイムのQoSデータにアクセスできます APIサービスはリクエストベースであり、アプリまたはユーザーが要求したデータを収集するために「プル」メカニズムを使用します。APIは、APIエンドポイントからデータをプルするために繰り返し呼び出す必要があるため、Webhookよりもリソース消費が大きくなります。 利用するお客様の声 [Zoom API](https://developers.zoom.us/docs/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エンドポイントを検証する](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イベントを選択します** お客様の声はまず、次の場所で一般またはサーバー間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 イベントを選択できます。
Image of the Event types screen, focused on QSS options.
Marketplace UIまたはAPI呼び出しを使用して、サブスクリプションを管理することもできます: * `POST /Marketplace/アプリ/イベント_subscription – 作成` * `PATCH /{id} – ユーザー/アカウントを購読する` * `DELETE /{id} – 購読解除/削除` * `GET /marketplace/アプリ/イベント_サブスクリプション – 一覧` API を介して認証するには、Client Credentials Grant のトークンを使用してください。 {% endstep %} {% step %} **Webhookイベントを確認する** イベントのサブスクリプションを設定した後、Webhook URLの所有権とイベントの真正性の両方が適切に認証されていることを確認してください。 * **URLの検証** * イベントのサブスクリプションを初めて有効にする際、ZoomはWebhook エンドポイントの所有権を確認するためにChallenge–Response Check（CRC）を実行します。このプロセスにより、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のイベントサブスクリプションAPI、Webhook Logs API、およびクライアント認証情報付与の認証ガイドを参照してください。 --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://library.zoom.com/technical-library/ja/kn/network-management/quality-of-service-subscription-explainer.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.