> 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-tw/guan-li-yuan-zhuan-qu/network-management/quality-of-service-subscription-explainer.md).
# 服務品質訂閱說明
### 品質服務訂閱是一項附加產品，透過事件訂閱串流傳送 Zoom 會議、網路研討會和 Zoom Phone 的近乎即時 QoS 遙測資料
Zoom 的品質服務訂閱（QSS）是一項附加產品，為 Zoom 會議、網路研討會和電話通話提供近乎即時的服務品質（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 支援會議、網路研討會和電話通話的即時事件資料
QSS 會為帳戶中所有使用者的 Zoom 會議與網路研討會，以及 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 服務是以請求為基礎，並使用「拉取」機制來收集應用程式或使用者要求的資料。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 事件**
客戶必須先在 [Zoom 應用程式市集](https://marketplace.zoom.us/)中建立一般型或伺服器對伺服器 OAuth 應用程式。接著，啟用事件訂閱並選取想接收的 QoS 事件。
接著，客戶必須輸入其應用程式的事件通知端點 URL，以指定 QSS 事件通知的目的地
{% hint style="info" %}
此設定不需要僅限 Webhook 的應用程式。Zoom 建議建立一般型應用程式。
{% endhint %}
{% endstep %}
{% step %}
**訂閱 QSS Webhook 事件**
若要訂閱 QSS 事件，客戶必須新增事件並從可用的 QSS **事件類型**清單中選取。客戶可在完成流程並啟用其應用程式之前，選取一或多個 QSS 事件。
您也可以透過市集 UI 或使用 API 呼叫來管理訂閱：
* `POST /marketplace/app/event_subscription – 建立`
* `PATCH /{id} – 訂閱使用者/帳戶`
* `DELETE /{id} – 取消訂閱/刪除`
* `GET /marketplace/app/event_subscription – 列出`
若要透過 API 驗證，請使用來自 Client Credentials Grant 的權杖。
{% endstep %}
{% step %}
**驗證 Webhook 事件**
設定事件訂閱後，請確保 webhook URL 所有權與事件真實性都已正確驗證。
* **URL 驗證**
* 當您第一次啟用事件訂閱時，Zoom 會執行挑戰回應檢查（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 中的 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 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-tw/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.