نمرات

این سند مفاهیم درجه بندی مرتبط با 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 تعیین کنند و اگر دانش‌آموز قبل از تاریخ، تکلیف را تحویل ندهد، StudentSubmissions مرتبط با یک فیلد late (بر روی true تنظیم شده) مشخص می‌شوند. معلمان همچنین می‌توانند ارسال‌های دیرهنگام را با تنظیمی در برنامه Classroom غیرفعال کنند .

علاوه بر این، StudentSubmissions که قبل از dueDate ارسال نشده‌اند، در دفترچه نمره کلاس درس به‌عنوان مفقود توضیح داده می‌شوند. معلمان همچنین می‌توانند موارد ارسالی را به‌عنوان مفقود شده در برنامه Classroom علامت‌گذاری کنند. تکالیف از دست رفته به طور خودکار یک draftGrade داده می شود که توسط معلم قابل تنظیم است اما به طور پیش فرض 0 است.

مطالب ارسالی از دست رفته می تواند توسط معلم به عنوان کامل یا معذور علامت گذاری شود. StudentSubmissions که به‌عنوان کامل علامت‌گذاری شده‌اند، فیلد پیش‌فرض draftGrade حذف می‌شود تا زمانی که معلم یک مورد جدید را به صورت دستی تنظیم کند. StudentSubmissions که به‌عنوان معذور علامت‌گذاری شده‌اند، از محاسبات نمره کلی ، از جمله دوره‌های درجه‌بندی حذف می‌شوند.

توجه: وضعیت‌های کامل، مفقود و معذور از StudentSubmissions به طور مشخص در API قابل شناسایی نیستند. اگر این رفتار بر برنامه شما تأثیر می‌گذارد، بازخورد خود را در این شماره برای توصیف تأثیر آن بر مورد استفاده خود بگذارید.

برای کسب اطلاعات بیشتر در مورد نحوه رسیدگی معلمان به ارسال‌ها، نمره را ببینید و مقاله راهنمای تکلیف را بازگردانید .

سیستم های درجه بندی و درجه بندی کلی

Classroom از چندین سیستم درجه بندی برای محاسبه نمرات کلی دانش آموزان در دوره پشتیبانی می کند. نمرات کلی را می توان مستقیماً از مجموع امتیازات، وزن بر اساس دسته بندی یا اصلاً محاسبه نکرد، محاسبه کرد.

برای آشنایی با سیستم های مختلف درجه بندی همراه با مثال، مقاله تنظیم درجه بندی را ببینید.

چند نکته کلیدی:

• منبع Course دارای یک شیء gradebookSettings با جزئیات مربوط به تنظیمات نمره درس است.
  • calculationType روش محاسبه دوره را مشخص می کند.
  • displaySettings مشخص می کند چه کسی می تواند نمرات کلی را در برنامه Classroom ببیند. بهترین روش این است که در صورت امکان به این موضوع در برنامه خود احترام بگذارید. برای مثال، اگر دانش‌آموزان نمی‌توانند نمره کلی خود را در Classroom ببینند، آن را در برنامه خود به آنها نشان ندهید.
  • gradeCategories شامل فهرستی از دسته‌های درجه‌بندی پیکربندی شده برای دوره، از جمله نام‌های نمایشی، درصد وزنی، و امتیازهای پیش‌فرض برای تکالیف مربوطه است.
• اگر یک دوره از درجه بندی وزنی استفاده می کند، ممکن است لازم باشد وزن ها را در سناریوهایی که دسته ای وجود ندارد، عادی کنید. برای مثال، اگر وزن‌های دسته‌بندی 20 درصد برای تکالیف، 10 درصد برای مسائل تمرین، و 70 درصد برای آزمون‌ها بود، اما هیچ مشکل تمرینی وجود نداشت، Classroom وزن‌ها را روی 22 درصد برای تکالیف خانه و 78 درصد برای آزمون‌ها در هنگام محاسبه تنظیم می‌کند. نمرات کلی اگر قصد دارید نمرات کلی Classroom را در برنامه خود منعکس کنید، باید همین کار را انجام دهید.

دوره های درجه بندی

معلمان می توانند تکالیف CourseWork را در یک دوره در محدوده های تاریخی متمایز به نام دوره های درجه بندی گروه بندی کنند. دوره های درجه بندی را می توان برای فیلتر کردن درس در نمای دفترچه نمره و ایجاد سطل های مجزا برای محاسبات نمره کلی استفاده کرد.

به عنوان مثال، یک معلم ممکن است دوره های نمره دهی ترم "بهار" و "پاییز" را ایجاد کند. نمره کلی برای دوره بهار فقط شامل StudentSubmissions می‌شود که در محدوده تاریخ بهار قرار دارند.

سیستم درجه بندی تعیین شده برای دوره به دوره های نمره دهی گسترش می یابد. بنابراین، اگر دوره‌های نمره‌دهی نمونه بهار و پاییز ذکر شده در درسی که از دسته‌های درجه‌بندی وزنی استفاده می‌کرد، تعیین می‌شد، در نهایت سه مجموعه از نمرات کلی برای دانش‌آموزان وجود داشت:

• نمره کلی برای تمام تکالیف در دوره.
• نمره کلی برای همه تکالیف در محدوده تاریخ بهار.
• نمره کلی برای همه تکالیف در محدوده تاریخ پاییز.

هر سه نمره کلی را با دسته های وزنی محاسبه می کنند.

برای دریافت نمای کلی از ویژگی ، اطلاعیه دوره های درجه بندی را ببینید.

پیش‌نمایش برنامه‌نویس: پشتیبانی API برای دوره‌های درجه‌بندی به‌عنوان بخشی از برنامه پیش‌نمایش برنامه‌نویس Google Workspace در دسترس است، که دسترسی زودهنگام به ویژگی‌های خاص را اعطا می‌کند.

دوره های درجه بندی CourseWork با gradingPeriodId گسترش می دهد که دوره نمره دهی را که تکلیف در آن قرار می گیرد مشخص می کند.

برای یادگیری نحوه خواندن و مدیریت دوره‌های درجه‌بندی با API ، راهنمای API دوره‌های درجه‌بندی را ببینید.

روبریک ها

معلمان می توانند Rubrics با تکالیف CourseWork ایجاد و مرتبط کنند، و از این روبریک ها به عنوان یک راهنما در هنگام نمره دادن StudentSubmissions مربوطه استفاده کنند.

برای آشنایی با نحوه استفاده معلمان از روبریک ها در Classroom به مقاله روبریک ها مراجعه کنید.

پیش‌نمایش توسعه‌دهنده: پشتیبانی API برای روبریک‌ها به‌عنوان بخشی از برنامه پیش‌نمایش برنامه‌نویس Google Workspace در دسترس است که دسترسی زودهنگام به ویژگی‌های خاص را اعطا می‌کند.

روبریک ها منبع StudentSubmissions را با فیلدهای اضافی گسترش می دهند:

• rubricId روبریکی را مشخص می کند که با CourseWork ارسالی مطابقت دارد.
• draftRubricGrades معرف معیارها و نمرات متغیرهایی است که معلم قبل از بازگرداندن مطالب ارسالی به دانش آموز پیش نویس کرده است.
• assignedRubricGrades نشان دهنده معیارها و امتیازاتی است که دانش آموز پس از بازگرداندن مطالب ارسالی توسط معلم دریافت می کند.

برای نحوه مدیریت روبریک ها و خواندن نمرات مرتبط با API، به راهنمای API روبریک ها مراجعه کنید.

مقیاس های درجه بندی

Classroom از مقیاس‌های درجه‌بندی قابل تنظیم پشتیبانی می‌کند، برای مثال، به معلمان اجازه می‌دهد نمرات عددی را به نمرات حرفی ترجمه کنند. این تنظیمات و داده‌های مربوطه در API در دسترس نیستند.