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