> 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/de/administrator-bereich/network-management/quality-of-service-subscription-explainer.md). # Dienstgüte-Abonnement (QSS) Erläuterung ### Dienstgüte-Abonnement (QSS) ist ein Add-on-Produkt, das nahezu in Echtzeit Dienstgüte (QoS)-Telemetrie für Zoom Meetings, Webinare und Zoom Phone über Event-Abonnements streamt Zoom’s Dienstgüte-Abonnement (QSS) ist ein Add-on-Produkt, das nahezu Echtzeit-Daten zur Dienstgüte (QoS) für Zoom Meetings, Webinare und Telefonanrufe bereitstellt. QSS erweitert die Produktfunktionen von Zoom, indem es participant-level QoS-Ereignisse in Intervallen auf Minutenebene sendet (Rate und Aggregation können je nach Konfiguration variieren). Kunden können diesen umfangreichen Datenstrom nutzen, um zu ermitteln, ob Netzwerkumgebungen die Dienste von Zoom beeinträchtigen. #### QSS liefert dieselben zugrunde liegenden QoS-Metriken wie in Zoom-Dashboards und APIs, aber Abtastung und Zeitsteuerung unterscheiden sich Der bestehende [Zoom Dashboard](https://support.zoom.us/hc/en-us/articles/204654719-Getting-started-using-the-Zoom-Dashboard-) bietet Netzwerkleistungs- und Nutzungsmetriken, die Kunden dabei helfen können, zu verstehen, wie Zoom in einer Netzwerkumgebung funktioniert. QSS bietet dieselben Zoom QoS-Daten, jedoch mit einer höheren Rate. Aufgrund dieser schnelleren Stichprobenrate werden aggregierte QoS-Metriken Werte anzeigen, die sich vom Haupt-Dashboard von Zoom unterscheiden. Diese Metriken zulassen Kunden jedoch weiterhin, sie in ihre eigenen Dashboard-Ansichten zu Konfigurieren, um Zoom-Daten mit zusätzlichen Systemen zu korrelieren. Die folgende Tabelle beschreibt die QoS-Daten, die über QSS an die Endpunkte eines Kunden geliefert werden.
QoS-Daten über QSS bereitgestellt
QualitätsmetrikenBitrate, Latenz, Jitter, Paketverlust, Auflösung, Bildrate, CPU-Auslastung
NutzungsmetrikenGerät, Netzwerk, Signalisierungsregion, Client-Version, Audio (E/A), Video (E/A)
HäufigkeitCa. 1 Event pro Minute, pro Teilnehmer (pro QoS-Metrik oder aggregierter Satz, abhängig von den Konto-Einstellungen).
DatenaufbewahrungEvent-Übermittlungsprotokolle werden 7 Tage lang über die Webhook Logs API aufbewahrt; historische QoS-Daten über API-Endpunkte können länger gespeichert bleiben (abhängig von der Lizenz).
#### Zoom Dashboard-Daten sollten nicht mit Daten verglichen werden, die über QSS an einen Endpunkt eines Drittanbieters eines Kunden übermittelt werden QSS und das Zoom Dashboard bieten zwei separate Mechanismen für den Zugriff auf Zoom QoS-Daten, die nicht verglichen werden sollten. Obwohl das Zoom Dashboard und QSS aus demselben Pool von QoS-Daten abrufen, stimmen die Daten in jedem Mechanismus aufgrund von Unterschieden im Abrufzeitpunkt und in der Häufigkeit der Datenübermittlung nicht überein. #### QSS unterstützt Echtzeit-Event-Daten für Zoom Meetings, Webinare und Zoom Phone-Anrufe QSS liefert QoS-Event-Daten für alle Benutzer auf einem Konto für Zoom Meetings und Webinare sowie für Zoom Phone-Anrufe. Da Zoom das letzte Stück der Anrufe nicht verwaltet, stellt QSS für Zoom Phone-Anrufe nur QoS-Event-Daten auf Kontoebene bereit und kann daher keine vollständige Sicht auf die erweiterten End-to-End-Teilnehmerdaten bieten. #### QSS-Daten enthalten keine Daten für externe Teilnehmer QSS stellt keine Daten für externe Meeting-Teilnehmer bereit. Allerdings kann QSS dabei helfen, genau zu bestimmen, welcher interne Meeting-Teilnehmer ein Problem hatte und worin dieses Problem bestand, sowie die Qualitäts- und Nutzungsmetriken, die Kunden zur Fehlerbehebung benötigen. ### QSS ermöglicht es Kunden, rohe QoS-Daten aus dem Zoom Dashboard in ihre bestehenden Workflows zu übernehmen Während Zoom-Kunden in der Vergangenheit Tools wie das Zoom Dashboard oder APIs verwenden konnten, um Zoom QoS-Daten anzuzeigen oder abzurufen, ermöglicht QSS das Streamen von Zoom-QoS-Telemetriedaten in Ihre Netzwerkverwaltungs- und Überwachungsplattformen über Event-Abonnements (Webhook oder WebSocket). #### QSS liefert QoS-Events nahezu in Echtzeit an Ihre abonnierten Endpunkte und reduziert so das API-Abfragen und die Auswirkungen von Ratenbegrenzungen QSS-Kunden können sich für QoS-Events und -Daten in nahezu Echtzeit anmelden, die an ihre Anwendung-Endpunkte übertragen werden, was dazu beiträgt, API-Kapazität freizusetzen und die Netzwerkauslastung zu optimieren. QSS ist eine Erweiterung von Zooms [Standard-Webhook-Dienst](https://developers.zoom.us/docs/api/webhooks/) weil es rohe QoS-Daten mit einer nahezu Echtzeit-Rate von 4 bis 6 Mal pro Minute an einen Endpunkt senden kann. #### QSS ermöglicht es Kunden, über das Zoom Dashboard auf QoS-Daten nahezu in Echtzeit zuzugreifen, ohne API-Ratenlimits zu erreichen API-Dienste sind anforderungsbasiert und verwenden einen „Pull“-Mechanismus, um von einem App oder Benutzer angeforderte Daten zu erfassen. APIs sind ressourcenintensiver als Webhooks, da sie wiederholte Aufrufe erfordern, um Daten von einem API-Endpunkt abzurufen. Kunden, die verwenden [Zoom-APIs](https://developers.zoom.us/docs/api/) Beim Abrufen von QoS-Daten aus dem Zoom Dashboard können Ratenlimits auftreten, was bedeutet, dass sie die maximale Anzahl an API-Aufrufen erreicht haben, die sie innerhalb eines bestimmten Zeitraums durchführen können. QSS erhöht die API-Ratenlimits nicht, reduziert jedoch die Bedenken der Kunden hinsichtlich von Ratenlimits, indem es rohe QoS-Daten an ihre Endpunkte sendet, anstatt die Kunden dazu zu zwingen, die Daten selbst abzurufen. #### QSS ermöglicht Kunden, rohe Zoom QoS-Daten zu nutzen und Fehlerbehebung mit ihrem bevorzugten Netzwerkmanagementsystem durchzuführen Bestimmte Kunden müssen möglicherweise ihre Netzwerkleistung bei mehreren Anwendungen gleichzeitig bewerten. QSS ermöglicht es ihnen, Zoom QoS-Daten in einem Dashboard zusammen mit anderen Daten in ihrer Anwendungssuite zu überwachen und bietet so eine flexible, skalierbare Möglichkeit, Zoom QoS-Daten zu nutzen und nahtlos in benutzerdefinierte Dashboards zu integrieren. #### Zoom QoS-Daten werden über TLS 1.2 übertragen QSS-Daten werden während der Übertragung mithilfe von TLS 1.2 oder höher verschlüsselt. Endpunkte müssen ein gültiges Certificate Authority (CA)-Zertifikat verwenden. Webhook-Anfragen enthalten einen Signatur-Header und einen Challenge-Response-Check für Verifizierung. Für zusätzliche Sicherheit werden Kunden aufgefordert, zu [ihre Webhook-Endpunkte validieren](https://developers.zoom.us/docs/api/webhooks/) unter Verwendung eines Challenge-Response-Checks (CRC). Das CRC bestätigt den Besitz und die Sicherheit ihrer Event-Benachrichtigungs-Endpunkt-URLs. ### Kunden können mit der Nutzung von QoS-Daten beginnen, indem sie eine Anwendung erstellen, die QSS-Ereignisse empfangen kann Nach dem Kauf des QSS Add-on-Plans durch einen Kunden muss mindestens ein Benutzer auf dem Konto über aktivierte Entwicklertools-Berechtigungen verfügen. Kunden können dann die folgenden drei Schritte verwenden, um eine Webhook-Anwendung zu erstellen, die QSS-Ereignissen abonnieren kann. Kunden können auch die [Zoom Entwicklerpaket](https://news.zoom.com/zoom-announces-developer-pack-resale-for-channel-partners/) mit aktiviertem QSS-Flag, das QSS mit anderen Entwicklertools bündelt. {% stepper %} {% step %} **Erstellen Sie eine Event-Subscription-App (General oder Server-to-Server OAuth). Aktivieren Sie Event-Subscriptions und auswählen Sie QoS-Events** Kunden müssen zuerst eine General- oder Server-to-Server-OAuth-App in der erstellen [Zoom App Marketplace](https://marketplace.zoom.us/). Dann würden sie Event-Abonnements aktivieren und die QoS-Events auswählen, die sie erhalten möchten. Weiter müssen Kunden das Ziel für QSS-Event-Benachrichtigungen angeben, indem sie die URL des Endpunkts für Event-Benachrichtigungen ihrer Anwendung eingeben {% hint style="info" %} Eine nur auf Webhook basierende App ist für diese Konfiguration nicht erforderlich. Zoom empfiehlt, eine General App zu erstellen. {% endhint %} {% endstep %} {% step %} **Abonnieren Sie QSS Webhook-Events** Um QSS-Events zu abonnieren, müssen Kunden Events hinzufügen und aus der Liste der verfügbaren QSS auswählen **Eventtypen**. Kunden können einen oder mehrere QSS-Events auswählen, bevor sie den Vorgang abschließen und ihre Anwendung aktivieren.
Image of the Event types screen, focused on QSS options.
Sie können Abonnements auch über die Marketplace-Benutzeroberfläche oder mithilfe von API-Aufrufen verwalten: * `POST /marketplace/app/event_subscription – erstellen` * `PATCH /{id} – Benutzer/Konten abonnieren` * `DELETE /{id} – abbestellen/löschen` * `GET /marketplace/app/event_subscription – Liste` Um sich über die API zu authentifizieren, verwenden Sie ein Token aus dem Client Credentials Grant. {% endstep %} {% step %} **Webhook-Events überprüfen** Nach der Konfiguration der Event-Abonnements sollten Sie sicherstellen, dass sowohl die Eigentümerschaft der Webhook-URL als auch die Authentizität der Events ordnungsgemäß validiert werden. * **URL-Validierung** * Wenn Sie Event-Abonnements zum ersten Mal aktivieren, führt Zoom einen Challenge–Response-Check (CRC) durch, um die Eigentümerschaft Ihres Webhook-Endpunkts zu verifizieren. Dieser Prozess stellt sicher, dass Zoom Daten an ein legitimes Ziel sendet, das von Ihrer App kontrolliert wird. (Sie können die CRC-Behandlung bei Bedarf in einem früheren Einrichtungsschritt einbeziehen.) * **Event-Verifizierung** * Jede eingehende Event-Benachrichtigung sollte von Ihrer Anwendung verifiziert werden, um zu bestätigen, dass sie von Zoom stammt. Die App kann eingehende Anfragen mithilfe des in jedem Webhook-Event bereitgestellten Signatur-Headers validieren. Entwickler, die eine Alternative zur standardmäßigen Signaturmethode bevorzugen, können eine der anderen unterstützten Verifizierungsoptionen verwenden, die in den Zoom Developer Docs beschrieben sind. * Verwenden Sie die Get Webhook Logs API, um bis zu sieben Tage an Webhook-Zustellungsdaten zu überprüfen, einschließlich Status, Wiederholungsanzahl und Trace-ID. {% endstep %} {% endstepper %} Für vollständige Implementierungsdetails lesen Sie bitte den [QSS Implementierungshandbuch](https://drive.google.com/file/d/1oOEUeizi5VqtMTJIn3E1dFbYcbuv-Y2n/view) für Entwickler. Technische Details finden Sie in den Leitfäden zur Event Subscription API, Webhook Logs API und zur Authentifizierung mit Client Credentials Grant in den Zoom Developer Docs. --- # 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/de/administrator-bereich/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.