> 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 QoS-Telemetrie für Zoom Meetings, Webinare und Zoom Phone über Event-Abonnements bereitstellt Zoom’s Dienstgüte-Abonnement (QSS) ist ein Add-on-Produkt, das nahezu in Echtzeit Dienstgüte (QoS)-Daten für Zoom Meetings, Webinare und Telefonanrufe bereitstellt. QSS erweitert die Produktfunktionalität von Zoom, indem es QoS-Ereignisse auf Teilnehmer-Ebene in Minutentakt-Intervallen sendet (Rate und Aggregation können je nach Konfiguration variieren). Kunden können diesen umfangreichen Datenstrom nutzen, um zu erkennen, ob Netzwerkumgebungen die Dienste von Zoom beeinträchtigen. #### QSS liefert die gleichen zugrunde liegenden QoS-Metriken, die in Zoom-Dashboards und APIs verwendet werden, aber Abtastung und Timing unterscheiden sich Das Vorhandene [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 betrieben wird. QSS bietet dieselben Zoom QoS-Daten, jedoch in einer höheren Rate. Aufgrund dieser schnelleren Abtastung werden aggregierte QoS-Metriken Werte Anzeigen, die sich vom Haupt-Zoom Dashboard 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 geliefert
QualitätsmetrikenBitrate, Latenz, Jitter, Paketverlust, Auflösung, Bildrate, CPU-Auslastung
NutzungsmetrikenGerät, Netzwerk, Signalisierungsregion, Client-Version, Audio (I/O), Video (I/O)
HäufigkeitCa. 1 Event pro Minute, pro Teilnehmer (pro QoS-Metrik oder aggregiertem Satz, abhängig von den Kontoeinstellungen).
DatenaufbewahrungProtokolle zur Event-Zustellung 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).
#### Daten aus dem Zoom Dashboard sollten nicht mit Daten verglichen werden, die über QSS an den Endpunkt eines Drittanbieters des Kunden geliefert 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 ziehen, stimmen die Daten in beiden Mechanismen nicht überein, da es Unterschiede beim Abrufzeitpunkt und bei der Häufigkeit der Datenlieferung gibt. #### QSS unterstützt Echtzeit-Eventdaten für Zoom Meetings, Webinare und Telefonanrufe QSS stellt für alle Nutzer eines Kontos QoS-Eventdaten für Zoom Meetings und Webinare sowie für Zoom Phone-Anrufe bereit. Da Zoom den letzten Abschnitt der Anrufe nicht verwaltet, stellt QSS für Zoom Phone-Anrufe nur QoS-Eventdaten auf Kontoebene bereit und kann daher keinen vollständigen Einblick in 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. QSS kann jedoch dabei helfen, zu ermitteln, welcher interne Meeting-Teilnehmer ein Problem hatte und welches Problem das war, 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 historisch gesehen Tools wie das Zoom Dashboard oder APIs verwenden konnten, um Zoom QoS-Daten anzuzeigen oder abzurufen, ermöglicht QSS Ihnen, Zoom QoS-Telemetriedaten über Event-Abonnements (Webhook oder WebSocket) in Ihre Netzwerkmanagement- und Monitoring-Plattformen zu streamen. #### QSS liefert Ihren abonnierten Endpunkten QoS-Events nahezu in Echtzeit und reduziert API-Polling sowie die Auswirkungen von Ratenbegrenzungen QSS-Kunden können Echtzeit-QoS-Events und -Daten abonnieren, die an ihre Anwendungsendpunkte übertragen werden, wodurch API-Kapazität freigesetzt und die Netzwerkauslastung optimiert wird. QSS ist eine Ergänzung zu Zooms [Standard-Webhook-Dienst](https://developers.zoom.us/docs/api/webhooks/) weil es rohe QoS-Daten mit einer nahezu in Echtzeit liegenden Frequenz von 4 bis 6 Mal pro Minute an einen Endpunkt senden kann. #### QSS ermöglicht Kunden den Zugriff auf nahezu in Echtzeit vorliegende QoS-Daten aus dem Zoom Dashboard, ohne API-Ratenlimits zu erreichen API-Dienste sind anfragebasiert und verwenden einen „Pull“-Mechanismus, um Daten zu sammeln, die von einer App oder einem Benutzer angefordert werden. APIs sind ressourcenintensiver als Webhooks, weil sie wiederholte Aufrufe benötigen, um Daten von einem API-Endpunkt abzurufen. Kunden, die nutzen [Zoom APIs](https://developers.zoom.us/docs/api/) beim Abrufen von QoS-Daten aus dem Zoom Dashboard können Ratenbegrenzungen auftreten, was bedeutet, dass sie die maximale Anzahl an API-Aufrufen erreicht haben, die sie innerhalb eines bestimmten Zeitraums tätigen können. QSS erhöht die API-Ratenbegrenzungen nicht, verringert jedoch die Bedenken der Kunden hinsichtlich Ratenbegrenzungen, indem rohe QoS-Daten an ihre Endpunkte übertragen werden, anstatt dass Kunden die Daten selbst abrufen müssen. #### QSS ermöglicht Kunden, rohe Zoom-QoS-Daten zu nutzen und die Fehlerbehebung mit ihrem bevorzugten Netzwerkmanagementsystem durchzuführen Bestimmte Kunden müssen möglicherweise ihre Netzwerkleistung für mehrere Anwendungen gleichzeitig bewerten. QSS ermöglicht ihnen, Zoom-QoS-Daten in einem Dashboard neben 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 mit TLS 1.2 oder höher verschlüsselt. Endpunkte müssen ein gültiges Zertifikat einer Zertifizierungsstelle (CA) verwenden. Webhook-Anfragen enthalten einen Signatur-Header und eine Challenge-Response-Prüfung zur Verifizierung. Für zusätzliche Sicherheit werden Kunden dazu aufgefordert, [ihre Webhook-Endpunkte zu validieren](https://developers.zoom.us/docs/api/webhooks/) unter Verwendung einer Challenge-Response-Prüfung (CRC). Die CRC bestätigt die Eigentümerschaft und Sicherheit ihrer Event-Benachrichtigung-Endpunkt-URLs. ### Kunden können mit der Nutzung von QoS-Daten beginnen, indem sie eine Anwendung erstellen, die QSS-Events empfangen kann Nachdem ein Kunde den QSS Add-on-Plan kauft, muss mindestens ein Benutzer auf dem Konto über aktivierte Entwicklerberechtigungen verfügen. Kunden können dann die folgenden drei Schritte verwenden, um eine Webhook Anwendung zu erstellen, die QSS-Ereignisse 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 zusammen mit anderen Entwicklerwerkzeugen bündelt. {% stepper %} {% step %} **Erstellen Sie eine Event-Abonnement-App (General oder Server-to-Server OAuth). Aktivieren Sie Event Subscriptions und auswählen QoS-Events** Kunden müssen zuerst eine allgemeine oder Server-zu-Server-OAuth App in der [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 Endpunkt-URL ihrer Anwendung für Event-Benachrichtigung eingeben {% hint style="info" %} Für diese Konfiguration ist keine reine Webhook-App erforderlich. Zoom empfiehlt, eine allgemeine 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 wählen **Eventtypen**. Kunden können ein oder mehrere QSS-Events auswählen, bevor sie den Prozess abschließen und ihre Anwendung aktivieren.
Image of the Event types screen, focused on QSS options.
Sie können Abonnements auch über die Marketplace-UI oder mithilfe von API-Aufrufen verwalten: * `POST /marketplace/app/event_subscription – erstellen` * `PATCH /{id} – Benutzer/Konten abonnieren` * `DELETE /{id} – Abonnement kündigen/löschen` * `GET /marketplace/app/event_subscription – auflisten` Zur Authentifizierung über die API verwenden Sie ein Token aus dem Client Credentials Grant. {% endstep %} {% step %} **Webhook-Events verifizieren** Nachdem Sie Event-Abonnements konfiguriert haben, stellen Sie sicher, dass sowohl der Besitz der Webhook-URL als auch die Event-Authentizität ordnungsgemäß validiert sind. * **URL-Validierung** * Wenn Sie Event-Abonnements erstmals aktivieren, führt Zoom einen Challenge–Response Check (CRC) durch, um den Besitz 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-Verarbeitung bei Bedarf in einen früheren Einrichtungsschritt aufnehmen.) * **Event-Validierung** * Jede eingehende Event-Benachrichtigung sollte von Ihrer Anwendung verifiziert werden, um zu bestätigen, dass sie von Zoom stammt. Die App kann eingehende Anfragen anhand des in jedem Webhook-Event bereitgestellten Signatur-Headers validieren. Entwickler, die eine Alternative zur standardmäßig verwendeten 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 beachten Sie bitte den [QSS Implementierungsleitfaden](https://drive.google.com/file/d/1oOEUeizi5VqtMTJIn3E1dFbYcbuv-Y2n/view) für Entwickler. Technische Details finden Sie in den Anleitungen zur Event Subscription API, zur Webhook Logs API und zur Authentifizierung über den 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.