يتناول هذا المستند مفاهيم التقييم ذات الصلة بواجهة برمجة التطبيقات Classroom API.
اطّلِع على مقالة الدرجة وتتبُّع المهام للتعرّف على رحلات المعلّم في وضع الدرجات في تطبيق Google Classroom.
CourseWork وStudentSubmissions
في Google Classroom، يسلّم الطلاب StudentSubmissions
المهام CourseWork
في Course
. يمكن تقييم CourseWork
أو عدم تقييمه. إذا تم تقييم CourseWork
، ستتضمّن قيمة maxPoints
تمثّل إجمالي عدد النقاط التي يمكن الحصول عليها في المهمة. إذا كانت قيمة maxPoints
صفرًا أو لم يتم تحديدها، تكون المهمة بدون درجة.
بالنسبة إلى المهام التي تتضمّن درجات، يضع المعلّمون draftGrade
درجة على
StudentSubmission
قبل إرجاعها إلى الطالب. عند إرجاع المهمة في تطبيق Classroom، يتم ضبط assignedGrade
تلقائيًا على StudentSubmission
، بالقيمة نفسها التي تم ضبطها على draftGrade
الحالي. يمكن للمطوّرين ضبط كلا الحقلين، ويجب عليهم محاكاة سلوك تطبيق Classroom. على سبيل المثال، لا يمكن ضبط assignedGrade
بدون draftGrade
. يتم تمثيل كلا الحقلين بأرقام عشرية، وإذا لم يتم ضبطهما، يعني ذلك أنّ المعلّم لم يحدّد الدرجة المقابلة بعد.
راجِع إنشاء الدرجات وإدارتها للاطّلاع على أمثلة رموز حول قراءة الدرجات وتحديدها وعرضها.
يمكن للطلاب إرسال عدة مهام CourseWork
نفسها، ويتم تتبُّع حالة التسليم وسجلّ الدرجات في StudentSubmission.submissionHistory
.
المهام المتأخرة والمعفاة وغير المكتملة في CourseWork
عند تعيين عناصر CourseWork
، يتم إنشاء عناصر نائبة StudentSubmissions
لكل طالب، حتى إذا لم يتفاعل الطالب مع الواجب المعني. يمكن للمعلّمين تحديد dueDate
في CourseWork
، ويتم وضع علامة StudentSubmissions
المرتبطة به في الحقل late
(يتم ضبطه على true
) إذا لم يسلّم الطالب المهمة قبل التاريخ المحدّد. يمكن للمعلّمين أيضًا إيقاف إرسال المهام الدراسية بعد الموعد النهائي من خلال أحد الإعدادات في تطبيق Classroom.
بالإضافة إلى ذلك، يتم وضع تعليق توضيحي على StudentSubmissions
التي لم يتم تسليمها قبل dueDate
في دفتر العلامات في Classroom للإشارة إلى أنّها لم يتم تسليمها. يمكن للمعلّمين أيضًا وضع علامة "لم يتم التسليم" يدويًا على المهام في تطبيق Classroom. يتم تلقائيًا وضع علامة draftGrade
على المهام التي لم يتم تسليمها، ويمكن للمعلّم تخصيص هذه العلامة، ولكن يتم ضبطها تلقائيًا على 0.
يمكن للمعلّم وضع علامة مكتملة أو معفى على المهام غير المرسَلة.
ستتم إزالة حقل draftGrade
التلقائي من الواجبات التي تم وضع علامة StudentSubmissions
عليها على أنّها مكتملة إلى أن يضبط المعلّم حقلًا جديدًا يدويًا. تتم إزالة StudentSubmissions
التي تم وضع علامة "معفى" عليها من عمليات احتساب الدرجة الإجمالية، بما في ذلك فترات التقييم.
يمكنك الاطّلاع على مقالة المساعدة وضع الدرجات وإرجاع مهمة لمعرفة المزيد حول كيفية تعامل المعلّمين مع عمليات التسليم.
الدرجة الكلية وأنظمة وضع الدرجات
يتيح Classroom أنظمة تقدير متعددة لاحتساب الدرجات الإجمالية للطلاب في الدورة التدريبية. يمكن احتساب الدرجات الإجمالية مباشرةً من إجمالي النقاط أو تقديرها حسب الفئة أو عدم احتسابها على الإطلاق.
يمكنك الاطّلاع على مقالة إعداد نظام وضع الدرجات للتعرّف على أنظمة وضع الدرجات المختلفة مع أمثلة.
في ما يلي بعض النقاط الرئيسية:
- يحتوي المرجع
Course
على عنصرgradebookSettings
يتضمّن تفاصيل حول إعدادات الدرجات في الدورة التدريبية.- تحدّد السمة
calculationType
طريقة احتساب الدرجة في الدورة التدريبية. - تحدّد السمة
displaySettings
المستخدمين الذين يمكنهم الاطّلاع على الدرجات الإجمالية في تطبيق Classroom. ومن أفضل الممارسات احترام هذه السمة في تطبيقك عند الإمكان. على سبيل المثال، إذا كان الطلاب لا يستطيعون الاطّلاع على درجاتهم الإجمالية في Classroom، لا تعرضها لهم في تطبيقك. - تحتوي
gradeCategories
على قائمة بفئات الدرجات التي تم ضبطها للدورة التدريبية، بما في ذلك الأسماء المعروضة ونسبة الترجيح والنقاط التلقائية للمهام الدراسية ذات الصلة.
- تحدّد السمة
- إذا كان أحد الصفوف يستخدم نظام وضع الدرجات المرجّح، قد تحتاج إلى تسوية الأوزان في الحالات التي لا تتوفّر فيها فئة. على سبيل المثال، إذا كانت أوزان الفئات% 20 للواجب المنزلي و% 10 للتمارين التطبيقية و% 70 للاختبارات القصيرة، ولكن لم تكن هناك أي تمارين تطبيقية، يعدّل Classroom الأوزان إلى% 22 تقريبًا للواجب المنزلي و%78 تقريبًا للاختبارات القصيرة عند احتساب الدرجات النهائية. إذا كنت تنوي عرض درجات Classroom الإجمالية في تطبيقك، عليك اتّخاذ الإجراء نفسه.
فترات وضع الدرجات
يمكن للمعلّمين تجميع CourseWork
المهام الدراسية في دورة تدريبية ضمن نطاقات زمنية مميّزة تُعرف باسم فترات وضع الدرجات. يمكن استخدام فترات التقييم لتصفية الواجبات الدراسية في عرض دفتر العلامات وإنشاء مجموعات منفصلة لاحتساب الدرجة الإجمالية.
على سبيل المثال، يمكن أن ينشئ المعلّم فترات تقييم للفصل الدراسي "الربيع" و "الخريف". ولن تتضمّن الدرجة الإجمالية لفترة الربيع سوى
StudentSubmissions
المطلوب تسليمها خلال النطاق الزمني لفترة الربيع.
ينطبق نظام وضع الدرجات الذي تم ضبطه للدورة التدريبية على فترات وضع الدرجات. لذا، إذا تم ضبط فترات وضع الدرجات المذكورة أعلاه في مثال الفصلين الدراسيين (الربيع والخريف) على دورة تدريبية تستخدم فئات الدرجات المقدَّرة، سيكون هناك في النهاية ثلاث مجموعات من الدرجات الإجمالية للطلاب:
- الدرجة الإجمالية لكل المهام في الدورة التدريبية
- الدرجة الإجمالية لجميع المهام في النطاق الزمني لفصل الربيع
- الدرجة الإجمالية لجميع المهام في النطاق الزمني لفصل الخريف
ستحتسب جميعها الدرجة الإجمالية باستخدام الفئات المقدَّرة.
يمكنك الاطّلاع على إشعار فترات وضع الدرجات للحصول على نظرة عامة على الميزة.
تمتد فترات وضع الدرجات CourseWork
مع gradingPeriodId
الذي يحدّد فترة وضع الدرجات التي تندرج فيها المهمة.
راجِع دليل واجهة برمجة التطبيقات لفترات التقييم للتعرّف على كيفية قراءة فترات التقييم وإدارتها باستخدام واجهة برمجة التطبيقات.
قواعد التقييم
يمكن للمعلّمين إنشاء Rubrics
وربطها بمهام CourseWork
، واستخدام هذه النماذج كدليل عند تقييم StudentSubmissions
ذات الصلة.
راجِع مقالة قواعد التقييم للتعرّف على كيفية استخدام المعلّمين لقواعد التقييم في Classroom.
توسّع نماذج التقييم المورد StudentSubmissions
بحقول إضافية:
rubricId
يحدّد قواعد التقييم التي تتوافق مع التقديمCourseWork
.- يمثّل
draftRubricGrades
المعايير ودرجات العناصر النائبة التي وضعها المعلّم قبل إعادة المَهمّة إلى الطالب. - يمثّل
assignedRubricGrades
المعايير والنتائج التي يحصل عليها الطالب بعد أن يرجع المعلّم المَهمّة.
يمكنك الاطّلاع على دليل واجهة برمجة التطبيقات الخاصة بنماذج التقييم لمعرفة كيفية إدارة نماذج التقييم وقراءة الدرجات ذات الصلة باستخدام واجهة برمجة التطبيقات.
مقاييس وضع الدرجات
يتيح Classroom استخدام مقاييس وضع الدرجات القابلة للتخصيص، مثلاً، السماح للمعلّمين بتحويل الدرجات الرقمية إلى درجات أحرف. هذه الإعدادات والبيانات المرتبطة بها غير متاحة في واجهة برمجة التطبيقات.