> 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-jiao-luo/network-management/quality-of-service-subscription-explainer.md). # 服务质量订阅说明 ### 服务质量订阅是一款附加组件产品，可通过事件 & 活动 &直播订阅为 Zoom Meetings、Webinars 和 Zoom Phone 流式传输近实时 QoS 遥测数据 Zoom 的服务质量订阅（QSS）是一款附加组件产品，可为 Zoom Meetings、Webinars 和电话通话提供近实时服务质量（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 使用率
使用指标设备、网络、信令区域、客户端版本、音频（输入/输出）、视频（输入/输出）
频率约每分钟 1 个 事件 & 活动 &直播，按每位参会者计算（根据 QoS 指标或聚合集合，取决于账户设置）。
数据保留事件 & 活动 &直播传递日志会通过 Webhook Logs API 保留 7 天；通过 API 端点获取的历史 QoS 数据可能保留更久（取决于许可证）。
#### Zoom 仪表板数据不应与通过 QSS 传送到客户第三方端点的数据进行比较 QSS 和 Zoom 仪表板提供了两种用于访问 Zoom QoS 数据的独立机制，不应将它们进行比较。虽然 Zoom 仪表板和 QSS 都从同一 QoS 数据池中提取数据，但由于检索时机和数据传送频率不同，各机制中的数据不会一致。 #### QSS 支持 Meetings、Webinars 和 Phone calls 的实时事件 & 活动 &直播数据 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/) 因为它可以以接近实时的频率每分钟 4 到 6 次将原始 QoS 数据发送到端点。 #### QSS 使客户能够在不触及 API 速率限制的情况下访问来自 Zoom 仪表板的近实时 QoS 数据 API 服务基于请求，并使用“拉取”机制来收集应用或用户请求的数据。与 Webhook 相比，API 更消耗资源，因为它们需要重复调用以从 API 端点拉取数据。 使用的客户 [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 附加组件方案后，账户中至少有一个用户必须启用开发者权限。然后，客户可以使用以下三个步骤创建一个可订阅 QSS 事件的 Webhook 应用程序。 客户也可以追求 [Zoom 开发者工具包](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 列表中选择 **事件 & 活动 &直播类型**. 客户可以在完成流程并激活其应用程序之前选择一个或多个 QSS 事件 & 活动 &直播。
Image of the Event types screen, focused on QSS options.
您还可以通过 Marketplace UI 或使用 API 调用来管理订阅： * `POST /marketplace/应用/事件 & 活动 &直播_subscription – 创建` * `PATCH /{id} – 订阅用户/账户` * `DELETE /{id} – 取消订阅/删除` * `GET /marketplace/应用/事件 & 活动 &直播_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 查看最多七天的 Webhook 传递数据，包括状态、重试次数和追踪 ID。 {% endstep %} {% endstepper %} 有关完整的实施细节，请参阅 [QSS 实施指南](https://drive.google.com/file/d/1oOEUeizi5VqtMTJIn3E1dFbYcbuv-Y2n/view) ，面向开发者。有关技术细节，请参阅 Zoom Developer Docs 中的事件 & 活动 &直播 订阅 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 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/zh/guan-li-yuan-jiao-luo/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.