# شرح اشتراك جودة الخدمات

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

اشتراك جودة الخدمات من Zoom (QSS) هو مكون إضافي يوفّر بيانات جودة الخدمات شبه الفورية لـ Zoom Meetings وWebinars ومكالمات الهاتف. يوسّع 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>جهاز، الشبكة، منطقة الإشارة، إصدار العميل، صوت (I/O)، فيديو (I/O)</td></tr><tr><td>التكرار</td><td>تقريبًا 1 فعالية لكل دقيقة، لكل مشارك (لكل مقياس من جودة الخدمات أو مجموعة مجمعة حسب الإعدادات في الحساب).</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 تعزيزًا لخدمة Zoom [خدمة خطاف الويب القياسية](https://developers.zoom.us/docs/api/webhooks/) لأنه يمكنه إرسال بيانات جودة الخدمات الأولية إلى نقطة نهاية بمعدل شبه آني يتراوح من 4 إلى 6 مرات في الدقيقة.

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

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

العملاء الذين يستخدمون [واجهات برمجة التطبيقات الخاصة بـ Zoom](https://developers.zoom.us/docs/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://developers.zoom.us/docs/api/webhooks/) باستخدام فحص التحدي-الاستجابة (CRC). سيؤكد CRC ملكية عناوين URL لنقاط نهاية إشعار الفعالية وأمانها.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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


---

# 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/technical-library-ar/rkn-almsuwl/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.