الدرجات

يقدّم هذا المستند مفاهيم وضع الدرجات ذات الصلة بواجهة برمجة التطبيقات Classroom API.

اطّلِع على مقالة منح الدرجات وتتبُّع المهام الدراسية للتعرّف على خطوات منح الدرجات التي يتّبعها المعلّمون في تطبيق Google Classroom.

الدورات الدراسية وعمليات الإرسال

في Google Classroom، يُرسِل الطلاب StudentSubmissions لمهام CourseWork في Course. يمكن تقييم CourseWork أو إلغاء تقييمه. إذا تم تقييم CourseWork، سيكون له قيمة maxPoints تمثل إجمالي عدد النقاط التي يستحقها الواجب. إذا كانت قيمة maxPoints هي صفر أو غير محدّدة، لن يتم تقييم المهمة.

بالنسبة إلى المهام الدراسية التي يتم تقييمها، يحدّد المعلّمون درجة draftGrade في StudentSubmission قبل إرجاعها إلى الطالب. عند عرض العينة التي تم إرسالها في تطبيق Classroom، يتم ضبط assignedGrade تلقائيًا على StudentSubmission، بالقيمة نفسها التي تم ضبطها على draftGrade الحالية. يمكن للمطوّرين ضبط هذين الحقلين، ويجب أن يحاكيان سلوك تطبيق Classroom. على سبيل المثال، لا يمكن ضبط assignedGrade بدون draftGrade. يتم تمثيل كلا الحقلين بأرقام عشرية، وفي حال عدم ضبطهما، يعني ذلك أنّ المعلّم لم يضبط الدرجة المقابلة بعد. اطّلِع على مقالة إنشاء الدرجات وإدارتها للحصول على أمثلة على الرموز البرمجية لقراءة الدرجات وإعدادها وعرضها.

يمكن للطلاب إرسال عدة ملفات في مهمة CourseWork نفسها، ويُتتبّع سجلّ حالة الإرسال والدرجات في StudentSubmission.submissionHistory.

الأعمال الدراسية المتأخرة والمقبولة والمفقودة

عند تعيين CourseWork عنصر، يتم إنشاء العنصر النائب StudentSubmissions لكل طالب، حتى إذا لم يتفاعل الطالب مع المهام الدراسية المقابلة. يمكن للمعلّمين ضبط dueDate في CourseWork، ويُوضع late (يتم ضبطه على true) في الحقل StudentSubmissions المرتبط إذا لم يسلّم الطالب المهمة قبل التاريخ. ويمكن للمعلّمين أيضًا إيقاف عمليات الإرسال المتأخّرة باستخدام إعداد في تطبيق Classroom.

بالإضافة إلى ذلك، يتم وضع تعليق توضيحي في دفتر العلامات في Classroom يفيد بأنّ StudentSubmissions التي لم يتم إرسالها قبل dueDate غير متوفّرة. يمكن للمعلّمين أيضًا وضع علامة يدويًا على العينات التي تم إرسالها على أنّها غير متوفّرة في تطبيق 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 المعايير والنتائج التي يحصل عليها الطالب بعد إرجاع المعلّم التسليم.

اطّلِع على دليل Rubrics API لمعرفة كيفية إدارة معايير التقييم وقراءة الدرجات ذات الصلة باستخدام واجهة برمجة التطبيقات.

مقاييس وضع الدرجات

يتيح Classroom استخدام مقاييس وضع الدرجات القابلة للتخصيص، على سبيل المثال، السماح للمعلّمين بتحويل الدرجات الرقمية إلى تقديرات أحرف. لا تتوفّر هذه الإعدادات والبيانات المقابلة لها في واجهة برمجة التطبيقات.