لدمج نظام معلومات الطلاب (SIS) مع Classroom، عليك التحقّق من أنّ منتجك يستوفي متطلبات الشراكة في Classroom من خلال تنفيذ مجموعة اختبارات الامتثال المقدَّمة.
الوصول إلى الاختبارات وتنفيذها
يمكنك الوصول إلى اختبارات المطابقة على GitHub. من أجل إجراء الاختبارات، تحتاج إلى ما يلي:
- عنوان URL للرمز المميّز لاسترداد بيانات اعتماد OAuth 2.0
- عنوان URL لـ OneRoster ينتهي بـ
/ims/oneroster/v1p1 - معرِّف العميل
- سر العميل
- عنوان البريد الإلكتروني الخاص بالمعلّم
هناك ثلاثة أقسام في مجموعة الاختبار:
- مزامنة الدرجات الأساسية
- فئات وضع الدرجات
- فترات وضع الدرجات
يمكنك إجراء الاختبارات باستخدام Google Colab أو Jupyter Notebook. تتيح لك كل من Colab وJupyter Notebook إجراء جميع الاختبارات في آنٍ واحد. يساعدك ذلك في إنشاء نتائج الاختبار لمشاركتها مع فريق Google Classroom.
متطلبات نظام معلومات الطالب والسلوك المتوقَّع
تهدف الاختبارات التي تحدّدها Google إلى الحفاظ على الاتساق وتقليل الأخطاء التي قد يواجهها المستخدمون عند استخدام عمليات دمج نظام معلومات الطالب مع Classroom. اطّلِع على الإرشادات التالية حول الاختبارات. في GitHub، يحتوي كل اختبار على عنوان تتم الإشارة إليه في المؤشرات. ضع في اعتبارك أن المؤشرات يمكن أن تساعد في توضيح الأسئلة، لكنها ليست قائمة شاملة بالاختبارات. تأكَّد من تنفيذ جميع الاختبارات المقدَّمة في GitHub.
مزامنة الدرجات الأساسية
| اختبار | المؤشرات |
|---|---|
| المعلّمون: GetAllTeachers | يتمّ طلب نقطة نهاية GET /teachers باستخدام مَعلمة طلب بحث limit. في الاختبارات اللاحقة، يتم استخدام هذه المَعلمة للتأكّد من إمكانية عرض منتجك لحجم صفحة يبلغ 10,000 صفحة. |
| المعلّمون: الحصول على GetAllTeachers باستخدام فلتر البريد الإلكتروني | يتمّ استدعاء نقطة نهاية GET /teachers باستخدام مَعلمة طلب البحث filter المستخدَمة للفلترة استنادًا إلى عنوان البريد الإلكتروني للمعلّم. سيؤدي ذلك إلى استخدام عنوان البريد الإلكتروني للمعلّم الذي قدّمته في قسم "بيانات الاعتماد" من الاختبارات. |
| الصفوف: GetClassesForStudent | يتمّ استدعاء نقطة نهاية /teachers/{teacher_sourced_id}/classes باستخدام مَعلمة طلب بحث filter المستخدَمة للفلترة استنادًا إلى الفئات النشطة. |
| الطلاب: GetStudentsForClass | يتمّ طلب نقطة نهاية GET /classes/{class_sourced_id}/students. يجب إرجاع عنوان البريد الإلكتروني للطالب في الردّ. |
| LineItem: إنشاء | لا يُشترط تحديد فئات وضع الدرجات أو فترات وضع الدرجات عند الاتصال بالرقم PUT /lineItems/{line_item_sourced_id}. |
| العنصر: تعديل | يجب ألا يؤدي طلب البيانات من واجهة برمجة التطبيقات إلى عرض خطأ في حال تضمين عنوان طويل للمهمة. يتضمّن الاختبار عنوان مهمة يبلغ طوله أكثر من 100 حرف. |
| النتيجة: تعديل | يجب أن يكون من الممكن ضبط score على قيمة أكبر من resultValueMax لتمثيل رصيد إضافي. |
| النتيجة: حذف | يجب إدخال نقطة نهاية DELETE /results/{result_sourced_id}. |
| العنصر (اختياري / تنظيف): حذف وحصول | نقطة نهاية DELETE /lineItems/{line_item_sourced_id} غير مطلوبة. وهو اختياري ويُستخدَم لتنظيف البيانات. نقطة النهاية GET /classes/{class_sourced_id}/lineItems اللاحقة اختيارية أيضًا وتُجري اختبارًا يُثبت أنّه تم حذف العنصر. |
فئات وضع الدرجات
| اختبار | المؤشرات |
|---|---|
| GetAllCategories أو GetCategoriesForClass | يجب توفير نقطة نهاية واحدة فقط من GET /categories، إما GetAllCategories أو GetCategoriesForClass. يمكنك تعليق الاختبار الذي لا تستخدمه في حال إجراء جميع الاختبارات في آنٍ واحد. |
| DeleteLineItem (اختياري / تنظيف) | اختبار DeleteLineItem اختياري ويمكن استخدامه لتنظيف البيانات. |
فترات وضع الدرجات
| اختبار | المؤشرات |
|---|---|
| GetGradingPeriodsForTerm | يتم اختبار مدى توفّر فترات وضع الدرجات من خلال استرداد term_sourced_id في اختبار GetAllClasses باستخدام الفلتر. يُستخدَم هذا العنصر term_sourced_id لاسترداد فترات التقييم في الفصل الدراسي من خلال طلب نقطة نهاية GET terms/{term_sourced_id}/gradingPeriods في اختبار GetGradingPeriodsForTerm. |
مشاركة نتائج الاختبار مع فريق Google Classroom
بعد إجراء الاختبارات، يتم إنشاء تقرير كامل يتضمن نتائج كل اختبار. تُستخدَم هذه الاختبارات لتحديد ما إذا كان منتجك يستوفي متطلبات استخدام Google OneRoster 1.1. نزِّل التقرير الذي تم إنشاؤه أو التقط لقطة شاشة له. أرسِل التقرير ورابطًا يؤدّي إلى شهادة ملف تعريف العميل في OneRoster 1.1 الخاصة بمنتجك إلى العنوان التالي: classroom-sis-external@google.com.
الحصول على الدعم
يُرجى إرسال أي أسئلة أو استفسارات على البريد الإلكتروني classroom-sis-external@google.com.