يتوافق Google Classroom مع مزامنة دفتر العلامات واستيراد قوائم الطلاب المسجّلين في الصف لعدد من "أنظمة معلومات الطالب" الممتثلة لمعيار OneRoster. تتعاون Google مع منصات "نظام معلومات الطالب" التي تستوفي متطلبات OneRoster التي تحدّدها Google.
تتيح الشراكة مع Classroom للمشرفين ربط صفوفهم في Classroom بـ "نظام معلومات الطالب".

الشكل 1: عندما تتعاون "أنظمة معلومات الطالب" مع Classroom، يمكن للمشرفين اختيار "نظام معلومات الطالب" في القائمة المنسدلة.
رحلة تطوير الشركاء في "نظام معلومات الطالب"
إذا كنت مهتمًا بالشراكة مع Classroom، يُرجى ملء نموذج إبداء الاهتمام.
أنشأ فريق Classroom مجموعة من اختبارات المطابقة التي يمكن لشركاء "نظام معلومات الطالب" المهتمين استخدامها للتعرّف على متطلبات Google. يمكنك إجراء اختبارات المطابقة قبل التواصل مع فريق Classroom لتحديد مدى استيفاء منتجك لمتطلبات Google.
الحصول على نطاق تجريبي للمطوّرين
قد تحتاج إلى الوصول إلى نسخة مباشرة من Google Classroom لإنشاء عملية تكامل والتحقق منها. يحتاج مستخدمو الاختبار المؤهّلون إلى إصدار Google Workspace for Education Plus. إذا لم يكن لديك إذن مشرف للوصول إلى نطاق Google Workspace for Education يتضمّن هذه التراخيص، أكمل الخطوات للحصول على نطاق اختبار للمطوّرين واطلب ترقية النطاق التجريبي. سيتم توفير نطاقك مع 10 تراخيص Google Workspace for Education Plus.
الوصول إلى الاختبارات وإجراؤها
لإجراء الاختبارات، تحتاج إلى ما يلي:
- عنوان URL للرمز المميّز لاسترداد بيانات اعتماد OAuth 2.0
- عنوان URL لمعيار OneRoster ينتهي بـ
/ims/oneroster/v1p2 - معرِّف العميل
- سر العميل
- عنوان بريد إلكتروني خاص بمعلّم
يمكنك إجراء الاختبارات باستخدام Google Colab أو Jupyter notebook. يتيح لك كل من Colab وJupyter notebook إجراء جميع الاختبارات في آنٍ واحد. يساعدك ذلك في إنشاء نتائج الاختبارات لمشاركتها مع فريق Google Classroom.
متطلبات "نظام معلومات الطالب" والسلوك المتوقّع
تم إنشاء الاختبارات التي تحدّدها Google لتزويد شركاء "نظام معلومات الطالب" المهتمين بطريقة لتحديد ما إذا كان منتجهم يستوفي متطلبات Google المتعلقة باستخدام OneRoster ولتقليل الأخطاء التي قد يواجهها المستخدمون عند استخدام عمليات تكامل "نظام معلومات الطالب" في 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. |
| LineItem: Create | فترات وضع الدرجات غير مطلوبة عند طلب PUT /lineItems/{line_item_sourced_id}. |
| LineItem: Edit | يجب ألا يعرض طلب بيانات من واجهة برمجة التطبيقات خطأً إذا تم تضمين عنوان واجب طويل. يتضمّن الاختبار عنوان مهمة يتألف من 100 حرف أو أكثر. |
| Result: Edit | يجب أن يكون من الممكن ضبط score على قيمة أكبر من resultValueMax لتمثيل الدرجات الإضافية. |
| Result: Delete | نقطة النهاية DELETE /results/{result_sourced_id} مطلوبة. |
| LineItem (اختياري / تنظيف): Delete and Get | نقطة النهاية DELETE /lineItems/{line_item_sourced_id} غير مطلوبة. وهي اختيارية وتُستخدَم لتنظيف البيانات. نقطة النهاية اللاحقة GET /classes/{class_sourced_id}/lineItems اختيارية أيضًا، وتختبر ما إذا تم حذف عنصر وضع الدرجات. |
مشاركة نتائج الاختبارات مع فريق Google Classroom
بعد إجراء الاختبارات، يتم إنشاء تقرير كامل يتضمّن نتائج كل اختبار. تُستخدَم هذه الاختبارات لتحديد ما إذا كان منتجك يستوفي متطلبات Google المتعلقة باستخدام OneRoster 1.2. نزِّل التقرير الذي تم إنشاؤه أو خذ لقطة شاشة له لمشاركته مع جهات الاتصال في فريق Google Classroom.