# مُفسِّر اشتراك جودة الخدمات

### اشتراك جودة الخدمات هو منتج مكون إضافي يبث بيانات القياس عن بُعد الخاصة بـ جودة الخدمات بشكل شبه فوري لاجتماعات Zoom والندوات عبر الإنترنت وZoom Phone عبر اشتراكات الفعالية

اشتراك جودة الخدمات (QSS) من Zoom هو منتج مكون إضافي يوفّر بيانات جودة الخدمات (جودة الخدمات) بشكل شبه فوري لاجتماعات Zoom والندوات عبر الإنترنت ومكالمات الهاتف. يوسّع QSS وظائف منتجات Zoom من خلال إرسال فعاليات جودة الخدمات على مستوى المشارك على فترات زمنية بالدقائق (قد يختلف المعدل والتجميع حسب التكوين). يمكن للعملاء استخدام هذا التدفق الغني للبيانات لتحديد ما إذا كانت بيئات الشبكة تؤثر في خدمات Zoom.

#### <mark style="color:أزرق;">يقدّم QSS مقاييس جودة الخدمات الأساسية نفسها المستخدمة في لوحات المعلومات وواجهات برمجة التطبيقات الخاصة بـ Zoom، لكن تختلف آلية أخذ العينات والتوقيت</mark>

الحالي [لوحة المعلومات في Zoom](https://support.zoom.us/hc/en-us/articles/204654719-Getting-started-using-the-Zoom-Dashboard-) يوفّر مقاييس أداء الشبكة والاستخدام، ما يمكن أن يساعد العملاء على فهم كيفية عمل Zoom في بيئة الشبكة. يوفّر QSS بيانات جودة الخدمات الخاصة بـ Zoom نفسها، ولكن بمعدل أسرع. وبسبب أخذ العينات بهذا المعدل الأسرع، ستُظهر مقاييس جودة الخدمات المجمعة قيماً مختلفة عن لوحة المعلومات الرئيسية في Zoom. ومع ذلك، لا تزال هذه المقاييس تتيح للعملاء كوَّنها ضمن طرق عرض لوحة المعلومات الخاصة بهم لربط بيانات Zoom بأنظمة إضافية.

يوضح الجدول أدناه بيانات جودة الخدمات التي يتم تسليمها إلى نقاط النهاية الخاصة بالعميل عبر QSS.

<table><thead><tr><th width="230"></th><th>بيانات جودة الخدمات التي يتم تسليمها عبر QSS</th></tr></thead><tbody><tr><td>مقاييس الجودة</td><td>معدل البت، وزمن الوصول، والتذبذب، وفقدان الحزم، والدقة، ومعدل الإطارات، واستخدام وحدة المعالجة المركزية</td></tr><tr><td>مقاييس الاستخدام</td><td>جهاز، الشبكة، منطقة الإشارات، إصدار العميل، صوت (إدخال/إخراج)، فيديو (إدخال/إخراج)</td></tr><tr><td>التكرار</td><td>حوالي فعالية واحدة في الدقيقة، لكل مشارك (لكل مقياس من مقاييس جودة الخدمات أو مجموعة مجمعة حسب إعدادات الحساب).</td></tr><tr><td>الاحتفاظ بالبيانات</td><td>يتم الاحتفاظ بسجلات تسليم الفعالية لمدة 7 أيام عبر واجهة برمجة التطبيقات لسجلات خطاف الويب؛ وقد تستمر بيانات جودة الخدمات التاريخية عبر نقاط نهاية واجهة برمجة التطبيقات لمدة أطول (بحسب الترخيص).</td></tr></tbody></table>

#### <mark style="color:أزرق;">يجب عدم مقارنة بيانات لوحة المعلومات في Zoom بالبيانات التي يتم تسليمها عبر QSS إلى نقطة نهاية خارجية خاصة بالعميل</mark>

يوفّر QSS ولوحة المعلومات في Zoom آليتين منفصلتين للوصول إلى بيانات جودة الخدمات الخاصة بـ Zoom، ويجب عدم مقارنتهما. وعلى الرغم من أن لوحة المعلومات في Zoom وQSS يستندان إلى المجموعة نفسها من بيانات جودة الخدمات، فإن البيانات في كل آلية لن تتطابق بسبب الاختلافات في توقيت الاسترجاع وتكرار تسليم البيانات.

#### <mark style="color:أزرق;">يدعم QSS بيانات الفعالية في الوقت الفعلي للاجتماعات والندوات عبر الإنترنت ومكالمات الهاتف</mark>

يوفّر QSS بيانات فعالية جودة الخدمات لجميع المستخدمين في الحساب لاجتماعات Zoom والندوات عبر الإنترنت، وكذلك لمكالمات Zoom Phone. ولأن Zoom لا تدير المرحلة الأخيرة من المكالمات، فإن QSS يوفّر فقط بيانات فعالية جودة الخدمات على مستوى الحساب لمكالمات Zoom Phone، ولذلك لا يمكنه توفير رؤية كاملة لبيانات المشارك المتقدمة من طرف إلى طرف.

#### <mark style="color:أزرق;">لا تتضمن بيانات QSS بيانات المشاركون الخارجيين</mark>

لا يوفّر QSS بيانات للمشاركون الخارجيين في الاجتماع. ومع ذلك، يمكن أن يساعد QSS في تحديد المشارك الداخلي في الاجتماع الذي واجه مشكلة وما كانت تلك المشكلة، بالإضافة إلى مقاييس الجودة والاستخدام التي سيحتاجها العملاء لاستكشاف المشكلات وإصلاحها.

### يتيح QSS للعملاء إدخال بيانات جودة الخدمات الأولية من لوحة المعلومات في Zoom إلى مسارات العمل الحالية لديهم

بينما كان بإمكان عملاء Zoom تاريخياً استخدام أدوات مثل لوحة المعلومات في Zoom أو واجهات برمجة التطبيقات لعرض بيانات جودة الخدمات الخاصة بـ Zoom أو استرجاعها، يتيح لك QSS بث بيانات القياس عن بُعد الخاصة بـ جودة الخدمات في Zoom إلى منصات إدارة الشبكة والمراقبة لديك عبر اشتراكات الفعالية (خطاف الويب أو WebSocket).

#### <mark style="color:أزرق;">يقدّم QSS فعاليات جودة الخدمات شبه الفورية إلى نقاط النهاية المشتركة لديك، مما يقلل من الاستطلاع المتكرر لواجهة برمجة التطبيقات وتأثير حدود المعدل</mark>

يمكن لعملاء QSS الاشتراك في فعاليات وبيانات جودة الخدمات في الوقت الفعلي التي سيتم دفعها إلى نقاط نهاية تطبيق الخاصة بهم، مما يساعد في تحرير سعة واجهة برمجة التطبيقات وتحسين استخدام الشبكة. يُعد QSS تعزيزاً لـ [خدمة خطاف الويب المعياري](https://marketplace.zoom.us/docs/api-reference/webhook-reference/) لأنه يمكنه إرسال بيانات جودة الخدمات الأولية إلى نقطة نهاية بمعدل شبه فوري يتراوح من 4 إلى 6 مرات في الدقيقة.

#### <mark style="color:أزرق;">يُمكّن QSS العملاء من الوصول إلى بيانات جودة الخدمات شبه الفورية من لوحة المعلومات في Zoom من دون بلوغ حدود معدل واجهة برمجة التطبيقات</mark>

تعتمد خدمات واجهة برمجة التطبيقات على الطلبات وتستخدم آلية "سحب" لجمع البيانات التي يطلبها تطبيق أو مستخدم. تُعد واجهات برمجة التطبيقات أكثر استهلاكاً للموارد من خطافات الويب لأنها تتطلب استدعاءات متكررة لسحب البيانات من نقطة نهاية واجهة برمجة التطبيقات.

العملاء الذين يستخدمون [واجهات برمجة التطبيقات الخاصة بـ Zoom](https://marketplace.zoom.us/docs/api-reference/zoom-api/) لسحب بيانات جودة الخدمات من لوحة المعلومات في Zoom قد يواجهون حدود المعدل، ما يعني أنهم بلغوا الحد الأقصى لعدد استدعاءات واجهة برمجة التطبيقات التي يمكنهم إجراؤها خلال فترة زمنية معينة. لا يزيد QSS من حدود معدل واجهة برمجة التطبيقات، لكنه يقلل من مخاوف العملاء بشأن حدود المعدل من خلال دفع بيانات جودة الخدمات الأولية إلى نقاط النهاية الخاصة بهم بدلاً من مطالبتهم بسحب البيانات بأنفسهم.

#### <mark style="color:أزرق;">يتيح QSS للعملاء استهلاك بيانات جودة الخدمات الأولية الخاصة بـ Zoom واستكشاف الأخطاء وإصلاحها باستخدام نظام إدارة الشبكة المفضل لديهم</mark>

قد يحتاج بعض العملاء إلى تقييم أداء شبكتهم عبر عدة تطبيقات في الوقت نفسه. يتيح لهم QSS مراقبة بيانات جودة الخدمات الخاصة بـ Zoom في لوحة معلومات إلى جانب بيانات أخرى ضمن مجموعة تطبيقات لديهم، مما يوفر طريقة مرنة وقابلة للتوسع لاستهلاك بيانات جودة الخدمات الخاصة بـ Zoom ودمجها بسلاسة في لوحات المعلومات المخصصة.

#### <mark style="color:أزرق;">يتم نقل بيانات جودة الخدمات الخاصة بـ Zoom عبر TLS 1.2</mark>

يتم تشفير بيانات QSS أثناء النقل باستخدام TLS 1.2 أو إصدار أعلى. يجب أن تستخدم نقاط النهاية شهادة صالحة من مرجع شهادات (CA). تتضمن طلبات خطاف الويب ترويسة توقيع وفحص تحدٍّ واستجابة من أجل التحقق.

لمزيد من الأمان، سيُطلب من العملاء [التحقق من نقاط نهاية خطاف الويب الخاصة بهم](https://marketplace.zoom.us/docs/api-reference/webhook-reference/#validate-your-webhook-endpoint) باستخدام فحص التحدي والاستجابة (CRC). سيؤكد CRC ملكية عناوين URL الخاصة بنقطة نهاية إشعار الفعالية وأمانها.

### يمكن للعملاء البدء في استهلاك بيانات جودة الخدمات من خلال إنشاء تطبيق يمكنه تلقي فعاليات QSS

بعد أن يشتري العميل خطة مكون إضافي QSS، يجب أن يكون لدى مستخدم واحد على الأقل في الحساب أذونات المطوّر ممكّنة. ويمكن للعملاء بعد ذلك استخدام الخطوات الثلاث التالية لإنشاء تطبيق خطاف ويب يمكنه الاشتراك في فعاليات QSS.

يمكن للعملاء أيضاً متابعة [حزمة مطوري Zoom](https://news.zoom.com/zoom-announces-developer-pack-resale-for-channel-partners/) مع تمكين علامة QSS، والتي تجمع QSS مع أدوات مطور أخرى.

{% stepper %}
{% step %}
**أنشئ تطبيق اشتراك فعالية (OAuth عام أو OAuth من خادم إلى خادم). تمكين اشتراكات الفعالية و يحدد فعاليات جودة الخدمات**

يجب على العملاء أولاً إنشاء تطبيق OAuth عام أو من خادم إلى خادم في [Zoom تطبيق سوق التطبيق](https://marketplace.zoom.us/). بعد ذلك، سيقومون بـ تمكين اشتراكات الفعالية و يحدد فعاليات جودة الخدمات التي يريدون تلقيها.

التالي، يجب على العملاء تحديد الوجهة لإشعارات فعالية QSS عن طريق إدخال عنوان URL لنقطة نهاية إشعار الفعالية الخاصة بتطبيقهم

{% hint style="info" %}
لا يلزم وجود تطبيق يقتصر على خطاف الويب فقط لهذا التكوين. يوصي Zoom بإنشاء تطبيق عام.
{% endhint %}
{% endstep %}

{% step %}
**اشترك في أحداث خطاف الويب الخاصة بـ QSS**

للاشتراك في أحداث QSS، يجب على العملاء إضافة الأحداث و اختر من قائمة QSS المتاحة **أنواع الفعالية**. يمكن للعملاء يحدد حدثًا واحدًا أو أكثر من أحداث QSS قبل إكمال العملية وتفعيل تطبيقهم.

<figure><img src="https://3637835738-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>

يمكنك أيضًا إدارة الاشتراكات عبر واجهة مستخدم سوق التطبيق أو باستخدام استدعاءات واجهة برمجة التطبيقات:

* `POST /سوق التطبيق/تطبيق/فعالية_subscription – إنشاء`
* `PATCH /{id} – الاشتراك للمستخدمين/الحسابات`
* `حذف /{id} – إلغاء الاشتراك/الحذف`
* `GET /سوق التطبيق/تطبيق/اشتراك_فعالية – قائمة`

للمصادقة عبر واجهة برمجة التطبيقات، استخدم الرمز المميز من منح بيانات اعتماد العميل.
{% endstep %}

{% step %}
**تحقق من أحداث خطاف الويب**

بعد تكوين اشتراكات الفعالية، تأكد من أن كلاً من ملكية عنوان URL لخطاف الويب وأصالة الفعالية يتم التحقق منهما بشكل صحيح.

* **التحقق من صحة عنوان URL**
  * عندما تمكين اشتراكات الفعالية لأول مرة، يقوم Zoom بإجراء فحص التحدي–الاستجابة (CRC) للتحقق من ملكية نقطة نهاية خطاف الويب الخاصة بك. تضمن هذه العملية أن Zoom يرسل البيانات إلى وجهة شرعية يتحكم فيها تطبيقك. (يمكنك تضمين معالجة CRC في خطوة إعداد سابقة إذا فضلت ذلك.)
* **التحقق من الفعالية**
  * يجب أن يتم التحقق من كل إشعار فعالية وارد بواسطة تطبيقك للتأكد من أنه صادر من Zoom. يمكن للتطبيق التحقق من صحة الطلبات الواردة باستخدام ترويسة التوقيع المقدمة في كل فعالية من خطاف الويب. يمكن للمطورين الذين يفضلون بديلاً لطريقة التوقيع الافتراضية استخدام أحد خيارات التحقق الأخرى المدعومة الموضحة في وثائق مطوري Zoom.
  * استخدم واجهة برمجة التطبيقات لسجلات خطاف الويب‏ Get Webhook Logs‏ لمراجعة ما يصل إلى سبعة أيام من بيانات تسليم خطاف الويب، بما في ذلك الحالة وعدد المحاولات وإط معرف التتبع trace ID.
    {% endstep %}
    {% endstepper %}

للاطلاع على تفاصيل التنفيذ الكاملة، يُرجى الرجوع إلى [دليل تنفيذ QSS](https://drive.google.com/file/d/1oOEUeizi5VqtMTJIn3E1dFbYcbuv-Y2n/view) للمطورين. للحصول على التفاصيل التقنية، راجع أدلة واجهة برمجة التطبيقات لاشتراك الفعالية، وسجلات خطاف الويب لواجهة برمجة التطبيقات، وموكل بيانات اعتماد العميل للمصادقة في وثائق مطوري Zoom.