لدمج نظام معلومات الطلاب (SIS) مع Classroom، عليك التحقّق من أنّ منتجك يستوفي متطلبات الشراكة في Classroom من خلال تنفيذ مجموعة اختبارات الامتثال المقدَّمة.
الوصول إلى الاختبارات وتنفيذها
يمكنك الوصول إلى اختبارات الامتثال على GitHub. لإجراء الاختبارات، تحتاج إلى ما يلي:
- عنوان URL للرمز المميّز لاسترداد بيانات اعتماد OAuth 2.0
- عنوان URL لـ OneRoster ينتهي بـ
/ims/oneroster/v1p1 - معرِّف العميل
- سر العميل
- عنوان بريد إلكتروني للمعلّم
تتضمّن مجموعة الاختبار ثلاثة أقسام:
- مزامنة الدرجات الأساسية
- فئات وضع الدرجات
- فترات وضع الدرجات
يمكنك إجراء الاختبارات باستخدام Google Colab أو مفكرة Jupyter. تتيح لك كل من Colab وJupyter Notebook إجراء جميع الاختبارات في آنٍ واحد. يساعدك ذلك في إنشاء نتائج الاختبار بهدف مشاركتها مع فريق Google Classroom.
متطلبات نظام إدارة المحتوى التعليمي (SIS) والسلوك المتوقّع
تم وضع الاختبارات التي تحدّدها Google للحفاظ على الاتساق والحدّ من الأخطاء التي قد يواجهها المستخدمون عند استخدام عمليات دمج أنظمة إدارة المؤسسات التعليمية مع Classroom. اطّلِع على الإرشادات التالية حول الاختبارات. في GitHub، يحتوي كل اختبار على عنوان تتم الإشارة إليه في المؤشرات. يُرجى العِلم أنّه يمكن أن تساعد المؤشرات في توضيح الأسئلة، ولكنها ليست قائمة شاملة للاختبارات. تأكَّد من تنفيذ جميع الاختبارات المقدَّمة في GitHub.
مزامنة الدرجات الأساسية
| اختبار | المؤشرات |
|---|---|
| المعلّمون: GetAllTeachers | يتمّ طلب نقطة نهاية GET /teachers باستخدام مَعلمة طلب بحث limit. في الاختبارات اللاحقة، يتم استخدام هذه المَعلمة لضمان أنّ منتجك يمكنه معالجة حجم صفحة يبلغ 10,000. |
| المعلّمون: الحصول على GetAllTeachers باستخدام فلتر البريد الإلكتروني | يتمّ استدعاء نقطة نهاية GET /teachers باستخدام مَعلمة طلب بحث filter المستخدَمة للفلترة استنادًا إلى عنوان البريد الإلكتروني للمعلّم. سيستخدِم هذا الإجراء عنوان البريد الإلكتروني للمعلّم الذي قدّمته في قسم "بيانات الاعتماد" من الاختبارات. |
| الفصول الدراسية: GetClassesForTeacher | يتمّ استدعاء نقطة نهاية /teachers/{teacher_sourced_id}/classes باستخدام مَعلمة طلب بحث filter المستخدَمة للفلترة استنادًا إلى الفئات النشطة. |
| الطلاب: GetStudentsForClass | يتمّ طلب نقطة نهاية GET /classes/{class_sourced_id}/students. يجب إرجاع عنوان البريد الإلكتروني الخاص بالطالب في الردّ. |
| العنصر: إنشاء | لا يُشترط تحديد فئات وضع الدرجات أو فترات وضع الدرجات عند طلب 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
بعد إجراء الاختبارات، يتم إنشاء تقرير كامل يتضمن نتائج كل اختبار. تُستخدَم هذه الاختبارات لتحديد ما إذا كان منتجك يستوفي متطلبات استخدام OneRoster 1.1 من Google. نزِّل التقرير الذي تم إنشاؤه أو التقط لقطة شاشة له. أرسِل التقرير ورابطًا يؤدّي إلى شهادة ملف تعريف العميل في OneRoster 1.1 الخاصة بمنتجك إلى العنوان classroom-sis-external@google.com.
الحصول على الدعم
يُرجى إرسال أي أسئلة أو استفسارات على البريد الإلكتروني classroom-sis-external@google.com.