بنية قواعد التقييم والقيود المعروفة

إذا لم تكن معتادًا على استخدام بطاقات تقييم 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 الأساسية للتعرّف على حساب تجريبي للتطوير وطلبه.