إذا لم تكن على دراية بميزة "بطاقات التقييم" في Classroom، يمكنك الاطّلاع على مقالات "مركز المساعدة" هذه للتعرّف على البنية العامة لبطاقة التقييم وكيفية التقييم باستخدام بطاقة التقييم في واجهة مستخدم Classroom.
بنية قواعد التقييم
في ما يلي بعض المفاهيم المهمة التي قد يكون من المفيد تسليط الضوء عليها عند استخدام واجهة برمجة التطبيقات للتفاعل مع نماذج التقييم:
- هناك نموذج تقييم واحد (على الأكثر) مرتبط
CourseWork
، ويكون نموذج التقييم هذا فريدًا بالنسبة إلىCourseWork
(لا يمكن مشاركته بين مواردCourseWork
). - تتألف قاعدة التقييم من معايير تتألف بدورها من مستويات. يجب أن تحتوي قاعدة التقييم دائمًا على معيار واحد على الأقل، ويجب أن يحتوي المعيار دائمًا على مستوى واحد على الأقل.
- يمكن أن تكون المستويات مصحوبة بدرجات (نقاط) أو غير مصحوبة بدرجات (بلا نقاط). يجب أن تكون المستويات
إما مسجّلة الدرجات بالكامل أو غير مسجّلة الدرجات بالكامل في نموذج التقييم.
- إذا تم احتساب الدرجات في المستويات، يجب أن تتضمّن جميع المستويات في أحد المعايير مجموعة فريدة من قيم النقاط. يمكن أن تكون النقاط أعدادًا صحيحة (مثل 10) أو قيمًا ذات فاصلة عشرية (مثل 9.99). يمكن أن يشمل ذلك الرقم 0. لا يتم قبول القيم الخالية. بالإضافة إلى ذلك، لا يمكن أن يتضمّن نموذج التقييم معيارًا واحدًا بمستوى واحد يساوي 0 نقطة.
- إذا كانت المستويات غير مسجّلة، يجب حذف حقل النقاط، ولا يتم قبول القيم الفارغة.
- إنّ ترتيب المعايير والمستويات مهم ويعكس الترتيب الذي تظهر به في واجهة مستخدم Classroom.
- يجب دائمًا ترتيب المستويات التي تتضمّن نتائج حسب النقاط بالترتيب التصاعدي أو التنازلي.
- يمكن أن تتضمّن كل بطاقة تقييم ما يصل إلى 50 معيارًا وما يصل إلى 10 مستويات أداء لكل معيار.
حقول إرسال الطالب ذات الصلة
تتضمّن عناصر StudentSubmission
حقولاً ذات صلة بقواعد التقييم:
- بالإضافة إلى السمتَين
draftGrade
وassignedGrade
الحالية، يتضمّن واجب الطالب الذي تم تقييمه باستخدام نموذج تقييم السمتَينdraftRubricGrades
وassignedRubricGrades
. تمثّل هذه السمة درجات التقييم (المستويات المحدّدة وقيم النقاط) التي يحصل عليها الطالب أثناء التقييم من نموذج التقييم، وذلك في حالتَي المسودة والتعيين على التوالي. - في الوقت الحالي، يمكن قراءة هذه المواقع الإلكترونية فقط. هذا يعني أنّه لا يمكن استخدام واجهة برمجة التطبيقات لوضع درجات على المهام التي تم تسليمها، ولكن يمكنك الاطّلاع على المهام التي تم وضع درجات عليها في واجهة مستخدم Classroom.
سلوكيات قواعد التقييم
تهدف واجهة برمجة التطبيقات إلى محاكاة واجهة مستخدم Classroom قدر الإمكان لتحقيق التناسق، ولكن قد يؤدي ذلك إلى سلوك غير بديهي للمطوّرين، لذا من المهم الإشارة إلى ما يلي:
- تهدف نماذج التقييم إلى توجيه عملية وضع الدرجات بدون تقييد المعلّمين. نتيجةً لذلك، يمكن للمعلّم إجراء ما يلي عند تقييم مهمة باستخدام نموذج تقييم:
- تجاهل قواعد التقييم تمامًا عند وضع الدرجات
- تجاوز النقاط المخصّصة لأحد المعايير، بغض النظر عن النقاط المتاحة في مستويات المعيار
- اختَر مستويات لمجموعة فرعية فقط من المعايير.
- تعيين نقاط لمعيار بدون اختيار مستوى مطابق
- تجاوز إجمالي نقاط المهمة، بغض النظر عن النقاط التي سيتم الحصول عليها من نموذج التقييم
بالإضافة إلى ذلك، لا تتيح واجهة برمجة التطبيقات سلوكًا لا تتضمّنه واجهة مستخدم Classroom. على سبيل المثال، لا تتيح واجهة برمجة التطبيقات فرض استخدام نماذج التقييم في المهام أو إلغاء قدرة المعلّم على تعديل نماذج التقييم والمستندات المرسَلة كما يمكنه فعل ذلك اليوم.
القيود أثناء وضع الدرجات
وبالمثل، هناك بعض القيود الإضافية المفروضة على تعديل قواعد التقييم بعد أن يبدأ المعلّم في وضع العلامات باستخدامها. لا يمكن إجراء سوى التعديلات التالية بعد بدء التقييم:
- يُسمح بتعديل النصوص الخاصة بمعايير التقييم ومستوياته وعناوينها وأوصافها.
- يمكن أن يتغيّر ترتيب المستويات ضمن المعايير.
النطاقات الإضافية
يمكن تصدير نماذج التقييم يدويًا إلى "جداول بيانات Google" ليتمكن المعلّمون من إعادة استخدامها.
إذا أنشأت أو عدّلت نموذج تقييم من جداول البيانات هذه (اطّلِع على مثال في الدليل)، يجب أن يطلب تطبيقك النطاق https://www.googleapis.com/auth/spreadsheets.readonly
أو https://www.googleapis.com/auth/spreadsheets
. يُرجى العِلم أنّ نطاقات
spreadsheets
تُعد حساسة وقد تتطلّب إثبات ملكية تطبيقك.
الدروس الدراسية التابعة لجهات خارجية
لا يمكن إنشاء نماذج التقييم إلا من خلال مشروع Google Cloud الذي أنشأ العنصر الأب CourseWork
. هذا نمط تصميم أوسع في Classroom API يمنع التطبيقات المختلفة من التأثير في الموارد التي لا تخصّها.
وينطبق ذلك أيضًا على المراجع التي ينشئها المستخدمون في تطبيق Classroom. على سبيل المثال، لا يمكن لأي تطبيق إدارة نماذج التقييم الخاصة بالواجبات التي أنشأها المعلّم في واجهة مستخدم Classroom، حتى إذا كان المعلّم نفسه هو مالك التطبيق. إذا كان ذلك يحدّ بشكل كبير من حالة الاستخدام، يُرجى مشاركة ملاحظاتك في أداة تعقُّب المشاكل العامة.
متطلبات الترخيص
لا يمكن للمستخدم إنشاء نماذج تقييم وتعديلها وحذفها باستخدام Classroom API إلا إذا استوفى الشروط التالية:
- يجب أن يكون لدى المستخدم الذي يقدّم الطلب ترخيص Google Workspace for Education Plus.
- يجب أن يكون لدى مالك الدورة التدريبية ترخيص Google Workspace for Education Plus للدورة التدريبية المعنية.
اطّلِع على أهلية المستخدم لمعرفة المزيد حول كيفية إتاحة إمكانات واجهة برمجة التطبيقات للمستخدمين، والمتطلبات الأساسية لواجهة برمجة التطبيقات Classroom API للتعرّف على حساب تجريبي وطلب الحصول عليه لأغراض التطوير.