محتوى هذه الصفحة مترجم آليًا. لا تضمن Zoom دقة المحتوى المترجم آليًا.
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

اشتراك جودة الخدمات هو منتج مكون إضافي يوفر بيانات جودة الخدمات للاجتماعات والندوات عبر الإنترنت والهاتف إلى نقطة نهاية تابعة لجهة خارجية لدى العميل.

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

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

يوفر QSS مقاييس جودة الخدمات الأساسية نفسها المستخدمة في لوحة المعلومات في Zoom وواجهات برمجة التطبيقات، لكن تختلف عملية أخذ العينات والتوقيت

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

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

بيانات جودة الخدمات المُسلَّمة عبر QSS

مقاييس الجودة

معدل البت، زمن الاستجابة، التذبذب، فقدان الحزم، الدقة، معدل الإطارات، استخدام وحدة المعالجة المركزية

مقاييس الاستخدام

جهاز، الشبكة، منطقة الإشارات، إصدار العميل، صوت (I/O)، فيديو (I/O)

التكرار

تقريبًا فعالية واحدة في الدقيقة، لكل المشارك (لكل مقياس جودة الخدمات أو المجموعة المجمعة حسب الإعدادات الخاصة بالحساب).

الاحتفاظ بالبيانات

تُحتفَظ بسجلات تسليم الفعاليات لمدة 7 أيام عبر واجهة برمجة التطبيقات لسجلات خطاف الويب؛ وقد تظل بيانات جودة الخدمات التاريخية عبر نقطة نهاية واجهة برمجة التطبيقات لفترة أطول (اعتمادًا على الترخيص).

لا ينبغي مقارنة بيانات لوحة المعلومات من Zoom بالبيانات التي يتم تسليمها عبر QSS إلى نقطة نهاية تابعة لطرف ثالث لدى العميل

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

يدعم QSS بيانات الفعالية في الوقت الفعلي للاجتماعات والندوات عبر الويب ومكالمات Zoom Phone

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

لا تتضمن بيانات QSS بيانات للمشاركون الخارجيون

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

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

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

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

يمكن لعملاء QSS الاشتراك في فعاليات جودة الخدمات والبيانات في الوقت الحقيقي التي سيتم دفعها إلى نقاط نهاية تطبيقاتهم، مما يساعد على إتاحة سعة واجهة برمجة التطبيقات وتحسين استخدام الشبكة. ويُعد QSS تعزيزًا لـ Zoom's خدمة خطاف الويب المعياري لأنه يمكنه إرسال بيانات جودة الخدمات الخام إلى نقطة نهاية بمعدل شبه فوري من 4 إلى 6 مرات في الدقيقة.

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

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

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

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

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

تُنقل بيانات جودة الخدمات من Zoom عبر TLS 1.2

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

لمزيد من الأمان، سيُطلب من العملاء أن التحقق من نقاط نهاية خطاف الويب الخاصة بهم باستخدام فحص تحدٍّ واستجابة (CRC). سيؤكد CRC ملكية عناوين URL لنقاط نهاية إشعار الفعالية الخاصة بهم وأمانها.

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

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

يمكن للعملاء أيضًا الحصول على حزمة Zoom Developer Pack مع تمكين علامة QSS، والتي تجمع QSS مع أدوات المطوّر الأخرى.

1

إنشاء تطبيق اشتراك في الفعاليات (OAuth عام أو من خادم إلى خادم). تمكين اشتراكات الفعاليات، ويحدد فعاليات جودة الخدمات

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

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

لا يُطلب تطبيق خاص بخطاف الويب فقط لهذا التكوين. توصي Zoom بإنشاء تطبيق عام.

2

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

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

Image of the Event types screen, focused on QSS options.

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

  • POST /سوق التطبيق/تطبيق/اشتراك_فعالية – إنشاء

  • PATCH /{id} – الاشتراك للمستخدمين/الحسابات

  • DELETE /{id} – إلغاء الاشتراك/الحذف

  • GET /سوق التطبيق/تطبيق/فعالية_الاشتراك – قائمة

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

3

تحقق من فعاليات خطاف الويب

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

  • التحقق من عنوان URL

    • عند تمكين اشتراكات الفعالية للمرة الأولى، يجري Zoom فحص التحدي والاستجابة (CRC) للتحقق من ملكية نقطة نهاية خطاف الويب الخاصة بك. تضمن هذه العملية أن Zoom يرسل البيانات إلى وجهة شرعية يتحكم بها تطبيقك. (يمكنك تضمين معالجة CRC في خطوة إعداد سابقة إذا كنت تفضل ذلك.)

  • التحقق من الفعالية

    • ينبغي أن يتحقق تطبيقك من كل إشعار بفعالية وارد للتأكد من أنه صادر من Zoom. يمكن لتطبيق التحقق من الطلبات الواردة باستخدام ترويسة التوقيع المتوفرة في كل فعالية لخطاف الويب. يمكن للمطورين الذين يفضلون بديلاً عن طريقة التوقيع الافتراضي استخدام أحد خيارات التحقق الأخرى المدعومة والموضحة في وثائق مطوري Zoom.

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

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

آخر تحديث

هل كان هذا مفيدا؟