> 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/technical-library-ar/rkn-almsuwl/network-management/quality-of-service-subscription-explainer.md).

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

### اشتراك جودة الخدمات هو منتج مكون إضافي يبث بيانات قياس عن بُعد لـجودة الخدمات في وقت شبه فعلي لاجتماعات 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>جهاز، الشبكة، منطقة الإشارات، إصدار العميل، صوت (I/O)، فيديو (I/O)</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 بيانات الفعالية في الوقت الفعلي للاجتماعات والندوات عبر الويب ومكالمات Zoom Phone</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's [خدمة خطاف الويب المعياري](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 %}
**إنشاء تطبيق اشتراك في الفعاليات (OAuth عام أو من خادم إلى خادم). تمكين اشتراكات الفعاليات، ويحدد فعاليات جودة الخدمات**

يجب على العملاء أولًا إنشاء تطبيق 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 /سوق التطبيق/تطبيق/فعالية_الاشتراك – قائمة`

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

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

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

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

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


---

# 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/technical-library-ar/rkn-almsuwl/network-management/quality-of-service-subscription-explainer.md?ask=<question>&goal=<endgoal>
```

`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.