> 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>جهاز، الشبكة، منطقة الإشارة، إصدار العميل، صوت (إدخال/إخراج)، فيديو (إدخال/إخراج)</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://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](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 /سوق التطبيق/تطبيق/فعالية_subscription – إنشاء`
* `PATCH /{id} – اشتراك المستخدمين/الحسابات`
* `حذف /{id} – إلغاء الاشتراك/الحذف`
* `GET /سوق التطبيق/تطبيق/فعالية_subscription – قائمة`

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

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

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

* **التحقق من صحة عنوان URL**
  * عندما تقوم أولًا بتمكين اشتراكات الفعاليات، يجري Zoom عملية فحص التحدي–الاستجابة (CRC) للتحقق من ملكية نقطة نهاية خطاف الويب الخاصة بك. تضمن هذه العملية أن Zoom يرسل البيانات إلى وجهة مشروعة يتحكم فيها تطبيقك. (يمكنك تضمين معالجة CRC في خطوة إعداد سابقة إذا رغبت.)
* **التحقق من الفعالية**
  * يجب أن يتم التحقق من كل إشعار فعالية وارد بواسطة تطبيقك للتأكد من أنه نشأ من Zoom. يمكن للتطبيق التحقق من صحة الطلبات الواردة باستخدام ترويسة التوقيع المتوفرة في كل فعالية خطاف الويب. يمكن للمطورين الذين يفضلون بديلاً عن طريقة التوقيع الافتراضي استخدام أحد خيارات التحقق الأخرى المدعومة والمذكورة في وثائق مطوري Zoom.
  * استخدم واجهة برمجة التطبيقات الخاصة بسجلات خطاف الويب Get لمراجعة ما يصل إلى سبعة أيام من بيانات تسليم خطاف الويب، بما في ذلك الحالة، وعدد المحاولات، ومعرّف التتبع.
    {% 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:

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