# Hizmet Kalitesi Aboneliği Açıklayıcısı

### Hizmet Kalitesi Aboneliği, Zoom Meetings, Webinars ve Zoom Phone için etkinlik abonelikleri aracılığıyla neredeyse gerçek zamanlı QoS telemetrisi akışı sağlayan bir eklenti üründür

Zoom’un Hizmet Kalitesi Aboneliği (QSS), Zoom Meetings, Webinars ve Phone aramaları için neredeyse gerçek zamanlı hizmet kalitesi (QoS) verileri sunan bir eklenti üründür. QSS, dakika düzeyinde aralıklarla katılımcı düzeyinde QoS Etkinlikleri göndererek Zoom’un ürün işlevselliğini genişletir (oran ve toplama, yapılandırmaya göre değişebilir). Müşteriler, bu zengin veri akışını kullanarak ağ ortamlarının Zoom’un hizmetlerini etkileyip etkilemediğini belirleyebilir.

#### <mark style="color:mavi;">QSS, Zoom Panolarında ve API’lerde kullanılan aynı temel QoS metriklerini sunar, ancak örnekleme ve zamanlama farklıdır</mark>

Mevcut [Zoom Pano](https://support.zoom.us/hc/en-us/articles/204654719-Getting-started-using-the-Zoom-Dashboard-) ağ performansı ve kullanım metrikleri sağlar; bu da Müşterilerin Zoom’un bir ağ ortamında nasıl çalıştığını anlamasına yardımcı olabilir. QSS, aynı Zoom QoS verilerini sunar, ancak daha yüksek bir hızda. Bu daha hızlı örnekleme hızı nedeniyle, toplanmış QoS metrikleri ana Zoom Panosu’ndan farklı değerler gösterir. Ancak bu metrikler yine de Müşterilerin, Zoom verilerini ek sistemlerle ilişkilendirmek için bunları kendi Pano görünümlerine Yapılandırmalarına izin verir.

Aşağıdaki tablo, QSS aracılığıyla bir müşterinin uç noktalarına iletilen QoS verilerini açıklar.

<table><thead><tr><th width="230"></th><th>QSS aracılığıyla iletilen QoS Verileri</th></tr></thead><tbody><tr><td>Kalite Metrikleri</td><td>Bit hızı, Gecikme, Jitter, Paket Kaybı, Çözünürlük, Kare Hızı, CPU Kullanımı</td></tr><tr><td>Kullanım Metrikleri</td><td>Cihaz, Ağ, Sinyalleşme Bölgesi, İstemci Sürümü, ses (G/Ç), Video (G/Ç)</td></tr><tr><td>Sıklık</td><td>Dakikada yaklaşık 1 Etkinlik, katılımcı başına (hesap Ayarlar'na bağlı olarak her QoS metriği veya toplu küme başına).</td></tr><tr><td>Veri Saklama</td><td>Etkinlik teslimi günlükleri, Web kancası Günlükleri API'si aracılığıyla 7 gün boyunca saklanır; API uç noktaları aracılığıyla geçmiş QoS verileri daha uzun süre kalabilir (lisans'a bağlı olarak).</td></tr></tbody></table>

#### <mark style="color:mavi;">Zoom Pano verileri, bir müşterinin üçüncü taraf uç noktasına QSS aracılığıyla teslim edilen verilerle karşılaştırılmamalıdır</mark>

QSS ve Zoom Pano, karşılaştırılmaması gereken Zoom QoS verilerine erişmek için iki ayrı mekanizma sağlar. Zoom Pano ve QSS aynı QoS veri havuzundan çekim yapsa da, alma zamanlaması ve veri teslim sıklığındaki farklılıklar nedeniyle her bir mekanizmadaki veriler birbiriyle eşleşmeyecektir.

#### <mark style="color:mavi;">QSS, Toplantılar, Web Seminerleri ve Telefon aramaları için gerçek zamanlı Etkinlik verilerini destekler</mark>

QSS, Zoom Meetings ve Webinars için ve ayrıca Zoom Phone çağrıları için bir hesaptaki tüm kullanıcılar adına QoS Etkinlik verisi sağlar. Zoom çağrıların son ayağını yönetmediğinden, QSS yalnızca Zoom Phone çağrıları için hesap düzeyinde QoS Etkinlik verisi sağlar ve bu nedenle uçtan uca gelişmiş katılımcı verileri üzerinde tam görünürlük sağlayamaz.

#### <mark style="color:mavi;">QSS verileri dış katılımcılar için veri içermez</mark>

QSS, dış toplantı katılımcıları için veri sağlamaz. Ancak QSS, hangi dahili toplantı katılımcısının sorun yaşadığını ve sorunun ne olduğunu belirlemenize yardımcı olabilir; ayrıca müşterilerin sorunları gidermek için ihtiyaç duyacağı kalite ve kullanım metriklerini de sunar.

### QSS, müşterilerin Zoom Pano'dan gelen ham QoS verilerini mevcut iş akışlarına aktarmasına olanak tanır

Zoom müşterileri tarihsel olarak Zoom Pano veya API'ler gibi araçları kullanarak Zoom QoS verilerini görüntüleyebilmiş ya da alabilmiş olsa da, QSS, olay abonelikleri (web kancası veya WebSocket) aracılığıyla Zoom QoS telemetrisini ağ yönetimi ve izleme platformlarınıza aktarmanıza olanak tanır.

#### <mark style="color:mavi;">QSS, abonelik verdiğiniz uç noktalara neredeyse gerçek zamanlı QoS Etkinlikleri sunar; API sorgulama sıklığını ve oran sınırı etkisini azaltır</mark>

QSS müşterileri, uygulama uç noktalarına iletilecek gerçek zamanlı QoS Etkinliklerine ve verilere abone olabilir; bu da API kapasitesini boşaltmaya ve ağ kullanımını optimize etmeye yardımcı olur. QSS, Zoom’un bir geliştirmesidir [standart web kancası hizmeti](https://developers.zoom.us/docs/api/webhooks/) çünkü ham QoS verilerini bir uç noktaya dakikada 4 ila 6 kez neredeyse gerçek zamanlı bir hızda gönderebilir.

#### <mark style="color:mavi;">QSS, müşterilerin API oran sınırlarına takılmadan Zoom Pano'dan neredeyse gerçek zamanlı QoS verilerine erişmesini sağlar</mark>

API hizmetleri istek tabanlıdır ve bir uygulama veya kullanıcı tarafından talep edilen verileri toplamak için bir “çekme” mekanizması kullanır. API’ler, bir API uç noktasından veri çekmek için yinelenen çağrılar gerektirdikleri için web kancalarından daha fazla kaynak tüketir.

Kullanan Müşteriler [Zoom API’leri](https://developers.zoom.us/docs/api/) Zoom Pano’dan QoS verilerini çekmek için rate limit’lerle karşılaşabilir; bu da belirli bir zaman aralığında yapabilecekleri maksimum API çağrısı sayısına ulaştıkları anlamına gelir. QSS, API rate limit’lerini artırmaz, ancak ham QoS verilerini müşterilerin uç noktalarına iterek müşterilerin rate-limit endişelerini azaltır; böylece müşterilerin veriyi kendilerinin çekmesini gerektirmez.

#### <mark style="color:mavi;">QSS, Müşterilerin ham Zoom QoS verilerini tüketmelerine ve tercih ettikleri ağ yönetim sistemiyle sorun gidermelerine olanak tanır</mark>

Belirli Müşterilerin aynı anda birden fazla uygulamadaki ağ performanslarını değerlendirmesi gerekebilir. QSS, onların bir pano içinde diğer uygulama paketlerindeki diğer verilerle birlikte Zoom QoS verilerini izlemelerine olanak tanır; böylece Zoom QoS verilerini tüketmek ve bunu özel panolara sorunsuzca entegre etmek için esnek ve ölçeklenebilir bir yol sağlar.

#### <mark style="color:mavi;">Zoom QoS Verileri TLS 1.2 üzerinden iletilir</mark>

QSS verileri, TLS 1.2 veya daha yüksek kullanılarak aktarım sırasında şifrelenir. Uç noktaların geçerli bir Sertifika Otoritesi (CA) sertifikası kullanması gerekir. Web kancası istekleri, Doğrulama için bir imza başlığı ve challenge-response kontrolü içerir.

Ek güvenlik için, müşterilerden [web kancası uç noktalarını doğrulamaları istenecektir](https://developers.zoom.us/docs/api/webhooks/) Bir Challenge-Response Check (CRC) kullanarak. CRC, Etkinlik Bildirim uç noktası URL'lerinin sahipliğini ve güvenliğini doğrulayacaktır.

### Müşteriler, QSS olaylarını alabilen bir uygulama oluşturarak QoS verilerini tüketmeye başlayabilir

Bir müşteri QSS eklenti planını satın aldıktan sonra, hesaptaki en az bir kullanıcının geliştirici izinleri etkinleştirilmiş olmalıdır. Müşteriler daha sonra QSS etkinliklerine abone olabilen bir web kancası uygulaması oluşturmak için aşağıdaki üç adımı kullanabilir.

Müşteriler ayrıca şunu da takip edebilir [Zoom Geliştirici Paketi](https://news.zoom.com/zoom-announces-developer-pack-resale-for-channel-partners/) QSS bayrağı etkinleştirilmiş haldeyken, QSS’yi diğer geliştirici araçlarıyla birlikte paketler.

{% stepper %}
{% step %}
**Bir Etkinlik Aboneliği uygulaması oluşturun (Genel veya Sunucudan Sunucuya OAuth). Etkinlik Aboneliklerini Etkinleştir ve QoS Etkinliklerini Seç**

Müşteriler önce bir Genel veya Sunucudan Sunucuya OAuth uygulaması oluşturmalıdır [Zoom App Marketplace](https://marketplace.zoom.us/). Sonra, Etkinlik Aboneliklerini etkinleştirir ve almak istedikleri QoS Etkinliklerini Seçerlerdi.

Sonraki olarak, Müşteriler uygulamalarının Etkinlik bildirim uç nokta URL’sini girerek QSS etkinlik Bildirimleri için hedefi belirtmelidir

{% hint style="info" %}
Yalnızca web kancası kullanan bir uygulama bu yapılandırma için gerekli değildir. Zoom, Genel bir uygulama oluşturmanızı önerir.
{% endhint %}
{% endstep %}

{% step %}
**QSS web kancası etkinliklerine abone olun**

QSS etkinliklerine abone olmak için, Müşteriler etkinlikler eklemeli ve uygun QSS listesinden Seç yapmalıdır **Etkinlik türleri**. Müşteriler, süreci tamamlayıp uygulamalarını etkinleştirmeden önce bir veya daha fazla QSS etkinliğini Seç yapabilir.

<figure><img src="/files/a1a46cf39ee31580c7f3e56c940d34056275b53a" alt="Image of the Event types screen, focused on QSS options."><figcaption></figcaption></figure>

Abonelikleri Marketplace kullanıcı arayüzü üzerinden veya API çağrıları kullanarak da yönetebilirsiniz:

* `POST /marketplace/uygulama/Etkinlik_subscription – oluştur`
* `PATCH /{id} – kullanıcıları/hesapları abone et`
* `DELETE /{id} – aboneliği kaldır/sil`
* `GET /marketplace/uygulama/Etkinlik_subscription – list`

API üzerinden kimlik doğrula için, Client Credentials Grant'tan bir belirteç kullanın.
{% endstep %}

{% step %}
**Web kancası olaylarını doğrulayın**

Etkinlik aboneliklerini yapılandırdıktan sonra, hem web kancası URL sahipliğinin hem de Etkinlik doğruluğunun uygun şekilde doğrulandığından emin olun.

* **URL Doğrulama**
  * Etkinlik aboneliklerini ilk kez Etkinleştirttiğinizde, Zoom web kancası uç noktanızın sahipliğini doğrulamak için bir Challenge–Response Check (CRC) gerçekleştirir. Bu işlem, Zoom'un verileri uygulamanız tarafından denetlenen meşru bir hedefe gönderdiğinden emin olur. (İsterseniz CRC işleyişini daha önceki bir kurulum adımına dahil edebilirsiniz.)
* **Etkinlik Doğrulama**
  * Her gelen etkinlik bildirimi, Zoom'dan kaynaklandığını doğrulamak için uygulamanız tarafından doğrulanmalıdır. uygulama, her web kancası Etkinlikinde sağlanan imza başlığını kullanarak gelen istekleri doğrulayabilir. varsayılan imza yöntemine bir alternatif tercih eden geliştiriciler, Zoom Developer Docs'ta açıklanan diğer desteklenen Doğrulama seçeneklerinden birini kullanabilir.
  * Durum, yeniden deneme sayısı ve izleme kimliği dahil olmak üzere en fazla yedi günlük web kancası teslim verilerini incelemek için Get Web kancası Logs API'sini kullanın.
    {% endstep %}
    {% endstepper %}

Tam uygulama ayrıntıları için lütfen şuraya bakın: [QSS Uygulama Kılavuzu](https://drive.google.com/file/d/1oOEUeizi5VqtMTJIn3E1dFbYcbuv-Y2n/view) geliştiriciler için. Teknik ayrıntılar için, Zoom Developer Docs içindeki Etkinlik Aboneliği API'si, Web kancası Günlükleri API'si ve Client Credentials Grant kimlik doğrulama kılavuzlarına bakın.


---

# Agent Instructions: 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:

```
GET https://library.zoom.com/technical-library/tr/yonetici-kosesi/network-management/quality-of-service-subscription-explainer.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.