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

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