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