> 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). # 服务质量订阅说明 ### 服务质量订阅是一款附加组件产品，可通过事件 & 活动 &直播订阅为 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 提供给客户终端的数据。
通过 QSS 提供的 QoS 数据
质量指标比特率、延迟、抖动、丢包率、分辨率、帧率、CPU 使用率
使用指标设备、网络、信令区域、客户端版本、音频（输入/输出）、视频（输入/输出）
频率约每位参会者每分钟 1 个 事件 & 活动 &直播（按每个 QoS 指标或汇总集，取决于账户设置）。
数据保留事件 & 活动 &直播 交付日志通过 Webhook 日志 API 保留 7 天；通过 API 端点访问的历史 QoS 数据可能会保留更久（取决于许可证）。
#### Zoom 仪表板数据不应与通过 QSS 交付给客户第三方端点的数据进行比较 QSS 和 Zoom 仪表板提供两种不同的访问 Zoom QoS 数据的机制，不应进行比较。虽然 Zoom 仪表板和 QSS 都取自同一组 QoS 数据，但由于检索时机和数据交付频率不同，各机制中的数据不会完全一致。 #### QSS 支持 Meetings、Webinars 和电话通话的实时 事件 & 活动 &直播 数据 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 使客户能够从 Zoom 仪表板访问接近实时的 QoS 数据，而不会触及 API 速率限制 API 服务是基于请求的，并使用“拉取”机制来收集应用或用户所请求的数据。API 比 Webhook 更消耗资源，因为它们需要反复调用才能从 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/应用/事件 & 活动 &直播_订阅 – 创建` * `PATCH /{id} – 订阅用户/账户` * `DELETE /{id} – 取消订阅/删除` * `GET /marketplace/应用/事件 & 活动 &直播_订阅 – 列表` 要通过 API 进行身份验证，请使用来自 Client Credentials Grant 的令牌。 {% endstep %} {% step %} **验证Webhook事件 & 活动 &直播** 配置事件 & 活动 &直播订阅后，请确保已正确验证Webhook URL 所有权和事件 & 活动 &直播真实性。 * **URL 验证** * 首次启用事件 & 活动 &直播订阅时，Zoom 会执行质询—响应检查 (CRC)，以验证您的Webhook端点的所有权。此过程可确保 Zoom 将数据发送到由您的应用控制的合法目标位置。（如果您愿意，也可以在较早的设置步骤中加入 CRC 处理。） * **事件 & 活动 &直播验证** * 您的应用程序应验证每个传入的事件 & 活动 &直播通知，以确认其来源为 Zoom。应用可使用每个Webhook事件 & 活动 &直播中提供的签名标头来验证传入请求。偏好采用默认签名方法替代方案的开发者，可使用 Zoom 开发者文档中所述的其他受支持验证选项之一。 * 使用获取Webhook日志 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 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-zhuan-qu/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.