> 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/zh/guan-li-yuan-zhuan-qu/network-management/quality-of-service-subscription-explainer.md).

# 服务质量订阅说明

服务质量订阅是一种附加组件产品，可将会议、网络研讨会和 Phone QoS 数据传送至客户的第三方端点。

### 服务质量订阅是一种附加组件产品，可通过事件订阅为 Zoom Meetings、Webinars 和 Zoom Phone 流式传输近乎实时的 QoS 遥测数据

Zoom 的服务质量订阅 (QSS) 是一种附加组件产品，可为 Zoom Meetings、Webinars 和电话通话提供近乎实时的服务质量 (QoS) 数据。QSS 扩展了 Zoom 的产品功能，按分钟级间隔发送参会者级别的 QoS 事件（频率和聚合方式可能因配置而异）。客户可以利用这一丰富的数据流，识别网络环境是否会影响 Zoom 服务。

#### <mark style="color:蓝色;">QSS 提供的底层 QoS 指标与 Zoom 仪表板和 API 中使用的指标相同，但采样方式和时间安排有所不同</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 个事件（具体为每项 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 数据的两种独立机制，不应将两者的数据进行比较。虽然 Zoom 仪表板和 QSS 使用同一组 QoS 数据，但由于数据检索时间和传递频率不同，两种机制中的数据不会完全一致。

#### <mark style="color:蓝色;">QSS 支持 Meetings、Webinars 和 Phone 通话的实时事件数据</mark>

QSS 为账户中的所有用户提供 Zoom Meetings 和 Webinars 的 QoS 事件数据，也提供 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 使客户能够近乎实时地访问 Zoom 仪表板中的 QoS 数据，而不会触及 API 速率限制。</mark>

API 服务基于请求运行，并使用“拉取”机制来收集应用或用户请求的数据。与 Webhook 相比，API 更消耗资源，因为它们需要反复调用 API 端点来拉取数据。

使用 [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 附加组件套餐后，账户中至少有一位用户必须启用开发者权限。随后，客户可以按照以下三个步骤创建可订阅 QSS 事件的 Webhook 应用程序。

客户也可以寻求 [Zoom 开发者套件](https://news.zoom.com/zoom-announces-developer-pack-resale-for-channel-partners/) 启用 QSS 标志后，可将 QSS 与其他开发者工具打包在一起。

{% stepper %}
{% step %}
**创建一个事件订阅应用（通用 OAuth 或服务器到服务器 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 列表中选择 **事件 & 活动 &直播类型**。客户可以在完成流程并激活其应用程序之前，选择一个或多个 QSS 事件。

<figure><img src="https://2325962437-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 – list`

要通过 API 进行身份验证，请使用通过客户端凭据授权获取的令牌。
{% endstep %}

{% step %}
**验证 Webhook 事件**

配置事件订阅后，请确保正确验证 Webhook URL 的所有权和事件的真实性。

* **URL 验证**
  * 首次启用事件订阅时，Zoom 会执行质询-响应检查（CRC），以验证您对 Webhook 端点的所有权。此过程可确保 Zoom 将数据发送到由您的应用控制的合法目标位置。（如有需要，您也可以在较早的设置步骤中处理 CRC。）
* **事件验证**
  * 您的应用程序应验证每条传入的事件通知，以确认其源自 Zoom。应用可以使用每个 Webhook 事件中提供的签名标头来验证传入请求。偏好使用默认签名方法以外方案的开发者，可以采用 Zoom 开发者文档中介绍的其他受支持验证选项之一。
  * 使用 Get Webhook Logs API 查看最多七天的 Webhook 传送数据，包括状态、重试次数和跟踪 ID。
    {% endstep %}
    {% endstepper %}

如需了解完整的实现详情，请参阅 [QSS 实施指南](https://drive.google.com/file/d/1oOEUeizi5VqtMTJIn3E1dFbYcbuv-Y2n/view) （面向开发者）。如需了解技术详情，请参阅 Zoom 开发者文档中的事件订阅 API、Webhook 日志 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 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/zh/guan-li-yuan-zhuan-qu/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.
