التحقّق من أنّ نظام معلومات الطالب يستوفي متطلبات Google Classroom

لدمج نظام معلومات الطالب مع Classroom، تحقّق من أنّ منتجك يستوفي متطلبات الشراكة في Classroom من خلال إجراء المجموعة المقدّمة من اختبارات المطابقة.

الوصول إلى الاختبارات وإجرائها

يمكنك الوصول إلى اختبارات المطابقة على GitHub. من أجل إجراء الاختبارات، تحتاج إلى ما يلي:

  • عنوان URL للرمز المميز لاسترداد بيانات اعتماد OAuth 2.0
  • عنوان URL لقائمة واحدة ينتهي بالأرقام /ims/oneroster/v1p1
  • معرِّف العميل
  • سر العميل
  • عنوان البريد الإلكتروني للمعلّم

هناك ثلاثة أقسام في مجموعة الاختبار:

  • مزامنة الدرجات الأساسية
  • فئات الدرجات
  • فترات وضع الدرجات

يمكنك إجراء الاختبارات باستخدام Google Colab أو Jupyter notebook. يتيح لك كل من Colab وJupyter notebook إجراء جميع الاختبارات في وقت واحد. يساعدك ذلك في إنشاء نتائج الاختبارات لمشاركتها مع فريق Google Classroom.

متطلبات نظام معلومات الطالب والسلوك المتوقَّع

تهدف الاختبارات التي تحدّدها Google إلى الحفاظ على التناسق وتقليل الأخطاء التي قد يواجهها المستخدمون عند استخدام عمليات دمج نظام معلومات الطالب مع Classroom. اقرأ المؤشرات التالية حول الاختبارات. في GitHub، يتم وضع علامة @title على كل اختبار. تمت الإشارة إلى هذه العناوين في المؤشرات.

  1. يُرجى ملاحظة ما يلي حول قسم "أداة مزامنة الدرجات الأساسية":

    • في اختبار GetAllTeachers، يتم استدعاء نقطة النهاية GET /teachers باستخدام مَعلمة طلب البحث limit=. وفي الاختبارات اللاحقة، يتم استخدام هذه المَعلمة للتأكّد من أنّ منتجك يتيح استخدام صفحة بحجم 10,000 صفحة.

    • في اختبار GetAllTeachers with email filter، يتم استدعاء نقطة النهاية GET /teachers باستخدام مَعلمة طلب بحث filter= تُستخدم للفلترة استنادًا إلى عنوان البريد الإلكتروني الخاص بالمعلّم. تحتاج إلى تحديد عنوان البريد الإلكتروني للمعلم عند إجراء الاختبارات.

    • في اختبار GetClassesForTeacher، يتم استدعاء نقطة النهاية /teachers/{teacher_sourced_id}/classes باستخدام مَعلمة طلب بحث filter= تُستخدم للفلترة بناءً على الفئات النشطة.

    • في اختبار GetStudentsForClass، يتم استدعاء نقطة نهاية GET /classes/{class_sourced_id}/students?limit=10000. يجب إرجاع البريد الإلكتروني الخاص بالطالب في الرد.

    • في اختبار "PutLineItem Create"، لا حاجة إلى فئات الدرجات أو فترات وضع الدرجات عند استدعاء PUT /lineItems/{line_item_sourced_id}.

    • في اختبار PutLineItem Edit، يجب ألا يعرض طلب البيانات من واجهة برمجة التطبيقات أي خطأ إذا تم تضمين طول عنوان تخصيص طويل. يتضمن الاختبار طول عنوان المهمة ما يزيد عن 100 حرف.

    • في اختبار PutResult Edit، من المفترض ضبط score على قيمة أكبر من resultValueMax لتمثيل رصيد إضافي.

    • يجب إدخال نقطة نهاية DELETE /results/{result_sourced_id} واختبارها في اختبار DeleteResult.

    • نقطة نهاية DELETE /lineItems/{line_item_sourced_id} غير مطلوبة. إنها اختيارية وتستخدم لتنظيف البيانات.

  2. يُرجى ملاحظة ما يلي حول قسمي فئات الدرجات وفترات وضع الدرجات:

    • يجب إدخال نقطة نهاية GET /categories واحدة فقط. علِّق على الرقم الذي لا تستخدمه في حال إجراء جميع اختبارات المطابقة مرة واحدة:
      • /categories?limit=10000
      • /classes/{class_sourced_id}/categories?limit=10000
    • يتم اختبار إمكانية وضع الدرجات من خلال استرداد term_sourced_id في اختبار GetAllClasses w/ filter. يتم استخدام term_sourced_id لاسترداد فترات وضع الدرجات في المصطلح من خلال طلب نقطة نهاية GET terms/{term_sourced_id}/gradingPeriods?limit=10000 في اختبار GetGradingPeriodsForTerm.

مشاركة نتائج الاختبارات مع فريق Google Classroom

بعد إجراء الاختبارات، يتم إنشاء تقرير كامل بنتائج كل اختبار. تُستخدَم هذه الاختبارات لتحديد ما إذا كان منتجك يفي بمتطلبات استهلاك OneRoster 1.1 لدى Google. نزِّل التقرير الذي تم إنشاؤه أو التقط لقطة شاشة له أرسِل التقرير ورابط يؤدي إلى شهادة OneRoster 1.1 الخاصة بمنتجك إلى classroom-sis-external@google.com.

الحصول على الدعم

يمكنك إرسال رسالة إلكترونية إلى classroom-sis-external@google.com إذا كانت لديك أي أسئلة أو استفسارات.