# 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 aktaran bir eklenti üründür

Zoom’ın Hizmet Kalitesi Aboneliği (QSS), Zoom Meetings, Webinars ve telefon aramaları için neredeyse gerçek zamanlı hizmet kalitesi (QoS) verileri sunan bir eklenti üründür. QSS, dakika düzeyindeki aralıklarla katılımcı düzeyinde QoS etkinlikleri göndererek Zoom’ın ü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ı ağ ortamlarının Zoom’ın hizmetlerini etkileyip etkilemediğini belirlemek için kullanabilir.

#### <mark style="color:mavi;">QSS, Zoom Panolarında ve API’lerinde 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’ın bir ağ ortamında nasıl çalıştığını anlamalarına yardımcı olabilir. QSS, aynı Zoom QoS verilerini sunar, ancak daha hızlı bir hızda. Bu daha hızlı örnekleme hızı nedeniyle, toplanmış QoS metrikleri ana Zoom Pano’dan farklı değerler gösterecektir. 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 sunulan QoS verilerini açıklar.

<table><thead><tr><th width="230"></th><th>QSS aracılığıyla Sunulan QoS Verileri</th></tr></thead><tbody><tr><td>Kalite Metrikleri</td><td>Bit hızı, Gecikme, Titreme, Paket Kaybı, Çözünürlük, Kare Hızı, CPU Kullanımı</td></tr><tr><td>Kullanım Metrikleri</td><td>Cihaz, Ağ, Sinyal Bölgesi, İstemci Sürümü, Ses (G/Ç), Video (G/Ç)</td></tr><tr><td>Sıklık</td><td>Katılımcı başına, dakika başına yaklaşık 1 etkinlik (hesap Ayarlarına bağlı olarak QoS metriği başına veya toplanmış küme).</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; geçmiş QoS verileri API uç noktaları aracılığıyla daha uzun süre kalabilir (lisansa bağlı olarak).</td></tr></tbody></table>

#### <mark style="color:mavi;">Zoom Pano verileri, QSS aracılığıyla bir müşterinin üçüncü taraf uç noktasına iletilen 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, veri alma zamanlaması ve veri teslim sıklığındaki farklılıklar nedeniyle her bir mekanizmadaki veriler eşleşmez.

#### <mark style="color:mavi;">QSS, Toplantılar, Web Seminerleri ve Zoom Phone görüşmeleri için gerçek zamanlı etkinlik verilerini destekler</mark>

QSS, bir hesaptaki tüm kullanıcılar için Zoom Meetings ve Web Seminerleri ile birlikte Zoom Phone görüşmeleri için QoS etkinlik verileri sağlar. Zoom, aramaların son ayağını yönetmediğinden, QSS yalnızca Zoom Phone görüşmeleri için hesap düzeyinde QoS etkinlik verileri sağlar ve bu nedenle uçtan uca gelişmiş katılımcı verisine tam görünürlük sağlayamaz.

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

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

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

Müşteriler Zoom QoS verilerini görüntülemek veya almak için geçmişte Zoom Pano veya API’ler gibi araçları kullanabilmiş olsa da, QSS size Zoom QoS telemetrisini etkinlik abonelikleri (web kancası veya WebSocket) aracılığıyla ağ yönetimi ve izleme platformlarınıza akıtma imkânı verir.

#### <mark style="color:mavi;">QSS, abone olduğunuz uç noktalara neredeyse gerçek zamanlı QoS Etkinlikleri iletir; böylece API sorgulamalarını ve hız sınırı etkisini azaltır</mark>

QSS müşterileri, uygulama uç noktalarına gönderilecek gerçek zamanlı QoS Etkinlikleri ve verilerine abone olabilir; bu da API kapasitesini boşaltmaya ve ağ kullanımını optimize etmeye yardımcı olur. QSS, Zoom’un [standart web kancası hizmetinin](https://marketplace.zoom.us/docs/api-reference/webhook-reference/) bir genişletmesidir; çünkü ham QoS verilerini bir uç noktaya dakikada 4 ila 6 kez olacak şekilde neredeyse gerçek zamanlı bir hızda gönderebilir.

#### <mark style="color:mavi;">QSS, müşterilerin API hız 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 ya da kullanıcı tarafından talep edilen verileri toplamak için bir “çekme” mekanizması kullanır. API’ler, verileri bir API uç noktasından çekmek için tekrarlanan çağrılar gerektirdikleri için web kancalarından daha fazla kaynak tüketir.

Zoom'u kullanan Müşteriler [Zoom API'leri](https://marketplace.zoom.us/docs/api-reference/zoom-api/) Zoom Pano'sundan QoS verilerini çekmek için kullanıldığında, belirli bir zaman dilimi içinde yapabilecekleri maksimum API çağrısı sayısına ulaştıkları anlamına gelen hız sınırlarıyla karşılaşabilirler. QSS, API hız sınırlarını artırmaz; ancak ham QoS verilerini Müşterilerin kendilerinin çekmesini gerektirmek yerine doğrudan uç noktalarına göndererek Müşterilerin hız sınırı endişelerini azaltır.

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

Belirli Müşterilerin ağ performanslarını aynı anda birden fazla uygulama üzerinde değerlendirmesi gerekebilir. QSS, Zoom QoS verilerini bir Pano içinde uygulama paketlerindeki diğer verilerle birlikte izlemelerine olanak tanıyarak Zoom QoS verilerini tüketmek ve bunu özel panolara sorunsuz şekilde 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 bir sürüm 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 üst bilgisi ve challenge-response kontrolü içerir.

Ek güvenlik için, Müşterilerden [web kancası uç noktalarını doğrulamaları](https://marketplace.zoom.us/docs/api-reference/webhook-reference/#validate-your-webhook-endpoint) bir Challenge-Response Check (CRC) kullanılarak istenecektir. CRC, Etkinlik bildirim uç noktası URL'lerinin sahipliğini ve güvenliğini doğrulayacaktır.

### Müşteriler, QSS olaylarını alabilecek 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 ardından QSS etkinliklerine abone olabilecek bir web kancası uygulaması oluşturmak için aşağıdaki üç adımı kullanabilir.

Müşteriler ayrıca şunları da takip edebilir:  [Zoom Geliştirici Paketi](https://news.zoom.com/zoom-announces-developer-pack-resale-for-channel-partners/) QSS bayrağı etkinleştirilmiş olarak, 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 içinde bir Genel veya Sunucudan Sunucuya OAuth uygulaması oluşturmalıdır [Zoom App Marketplace](https://marketplace.zoom.us/). Sonra, Etkinlik Aboneliklerini Etkinleştirirler ve almak istedikleri QoS Etkinliklerini Seçerler.

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

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

{% step %}
**QSS web kancası olaylarına abone olun**

QSS olaylarına abone olmak için müşteriler olayları Eklemeli ve uygun QSS listesinden Seçmelidir **Etkinlik türleri**. Müşteriler, işlemi tamamlayıp uygulama etkinleştirmeden önce bir veya daha fazla QSS olayı seçebilir.

<figure><img src="https://4003797241-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2Fgit-blob-0e6bcd7f34f9ebd6a9342919e58f15d0e72d51d0%2Fsubscribe-to-qss-webhook.png?alt=media" alt="Image of the Event types screen, focused on QSS options."><figcaption></figcaption></figure>

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

* `POST /marketplace/uygulama/Etkinlik_aboneliği – oluştur`
* `PATCH /{id} – kullanıcıları/hesapları abone yap`
* `DELETE /{id} – abonelikten çık / sil`
* `GET /marketplace/uygulama/Etkinlik_aboneliği – liste`

API aracılığıyla kimlik doğrulamak için, İstemci Kimlik Bilgileri Verme akışından bir belirteç kullanın.
{% endstep %}

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

Etkinlik aboneliklerini yapılandırdıktan sonra, hem web kancası URL sahipliğinin hem de Etkinlik özgünlüğünün uygun şekilde doğrulandığından emin olun.

* **URL Doğrulama**
  * Etkinlik aboneliklerini ilk kez Etkinleştir dediğ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 kontrol edilen meşru bir hedefe gönderdiğinden emin olur. (Tercih ederseniz CRC işlemeyi daha önceki bir kurulum adımına dahil edebilirsiniz.)
* **Etkinlik Doğrulama**
  * Gelen her Etkinlik bildirimi, Zoom'dan geldiğini doğrulamak için uygulamanız tarafından doğrulanmalıdır. uygulama, her web kancası Etkinliğinde sağlanan imza üst bilgisini kullanarak gelen istekleri doğrulayabilir. varsayılan imza yöntemine bir alternatifi tercih eden geliştiriciler, Zoom Geliştirici Belgeleri'nde açıklanan diğer desteklenen Doğrulama seçeneklerinden birini kullanabilir.
  * Durum, yeniden deneme sayısı ve izleme kimliği dahil olmak üzere yedi güne kadar olan web kancası teslimat verilerini incelemek için Web kancası Günlüklerini Al API'yi 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'taki Etkinlik Subscription API, Web kancası Logs API ve Client Credentials Grant kimlik doğrulama kılavuzlarına bakın.