В этом документе излагаются концепции оценивания, относящиеся к Classroom API.
Подробнее об оценке работ учителями в приложении Google Classroom можно узнать в статье об оценках и отслеживании заданий .
Курсовые работы и студенческие работы
В Google Classroom студенты сдают задания CourseWork
в Course
StudentSubmissions
. CourseWork
может быть оцененным или неоцененным. Если CourseWork
оценен, у него есть значение maxPoints
, которое указывает общую стоимость задания. Если maxPoints
равен нулю или не указан, задание не оценивается.
Для заданий с оценкой преподаватели устанавливают оценку draftGrade
в объекте StudentSubmission
, прежде чем вернуть его студенту. При возврате работы в приложение Classroom в объекте StudentSubmission
автоматически устанавливается значение assignedGrade
с тем же значением, что и текущее значение draftGrade
. Разработчики могут задать оба этих поля, и им необходимо эмулировать поведение приложения Classroom. Например, значение assignedGrade
невозможно задать без значения draftGrade
. Оба поля представлены десятичными числами, и если оно не задано, это означает, что преподаватель ещё не выставил соответствующую оценку. Примеры кода для чтения, установки и возврата оценок см. в разделе «Создание и управление оценками ».
Студенты могут подавать несколько заявок на одно и то же задание CourseWork
, а состояние отправки и история оценок отслеживаются в StudentSubmission.submissionHistory
.
Опоздавшие, уважительные и пропущенные задания CourseWork
При назначении элементов CourseWork
для каждого студента создаются заглушки StudentSubmissions
, даже если студент ещё не работал с соответствующим заданием. Преподаватели могут установить dueDate
для CourseWork
, и соответствующие StudentSubmissions
будут помечены полем с late
(значением true
), если студент не сдаёт задание до указанной даты. Преподаватели также могут отключить функцию сдачи с опозданием с помощью настройки в приложении Classroom.
Кроме того, StudentSubmissions
, не сданные до dueDate
, отмечаются в журнале оценок Classroom как отсутствующие . Преподаватели также могут вручную отмечать работы как отсутствующие в приложении Classroom. Отсутствующим работам автоматически присваивается draftGrade
, которую преподаватель может настроить, но по умолчанию она равна 0.
Преподаватель может отметить пропущенные работы как выполненные или оправданные . StudentSubmissions
отмеченных как выполненные, поле draftGrade
по умолчанию удаляется до тех пор, пока преподаватель не добавит новое значение вручную. StudentSubmissions
отмеченные как оправданные, исключаются из расчета общего балла , включая периоды оценки .
Ознакомьтесь со статьей «Оценка и возврат заданий», чтобы узнать больше о том, как преподаватели могут обрабатывать отправленные работы.
Общая оценка и системы оценок
Classroom поддерживает несколько систем оценок для подсчёта общих оценок студентов за курс. Общие оценки могут быть рассчитаны непосредственно на основе общего количества баллов, взвешены по категориям или не рассчитаны вовсе.
Ознакомьтесь со статьей о настройке оценок , чтобы узнать о различных системах оценок с примерами.
Некоторые ключевые моменты:
- Ресурс
Course
имеет объектgradebookSettings
с подробной информацией о настройках оценок курса.-
calculationType
указывает метод расчета для курса. -
displaySettings
определяет, кто может видеть общие оценки в приложении «Класс». Рекомендуется по возможности учитывать это в вашем приложении. Например, если учащиеся не видят свои общие оценки в приложении «Класс», не показывайте их им в вашем приложении. -
gradeCategories
содержит список категорий оценок, настроенных для курса, включая их отображаемые названия, процентный вес и баллы по умолчанию для соответствующих заданий.
-
- Если в курсе используется взвешенная система оценок, вам может потребоваться нормализовать веса в случаях, когда категория отсутствует. Например, если веса категорий составляли 20% для домашних заданий, 10% для практических задач и 70% для контрольных работ, но практических задач фактически не было, Classroom корректирует веса до ~22% для домашних заданий и ~78% для контрольных работ при расчёте общих оценок. Если вы хотите использовать общие оценки Classroom в своей заявке, вам необходимо сделать то же самое.
Периоды оценки
Преподаватели могут группировать задания CourseWork
в рамках курса по отдельным диапазонам дат, называемым оценочными периодами . Оценочные периоды можно использовать для фильтрации курсовых работ в журнале оценок и создания отдельных групп для расчёта общих оценок.
Например, преподаватель может создать оценочные периоды «весенний» и «осенний» семестры. Общий балл за весенний период будет включать только работы, сданные StudentSubmissions
в весенний период.
Система оценок, установленная для курса, распространяется и на оценочные периоды. Таким образом, если бы вышеупомянутые весенний и осенний оценочные периоды были установлены для курса, использующего взвешенные категории оценок, в конечном итоге студенты получили бы три набора общих оценок:
- Общая оценка по всем заданиям курса.
- Общая оценка за все задания за весенний период.
- Общая оценка за все задания за осенний период.
Все три варианта рассчитают общую оценку с учетом весовых категорий.
Ознакомьтесь с объявлением об оценочных периодах, чтобы получить общее представление об этой функции.
Оценочные периоды расширяют CourseWork
с помощью gradingPeriodId
, который определяет оценочный период, к которому относится задание.
Ознакомьтесь с руководством по API оценочных периодов , чтобы узнать, как читать и управлять оценочными периодами с помощью API.
Рубрики
Преподаватели могут создавать и связывать Rubrics
с заданиями CourseWork
, а также использовать эти рубрики в качестве руководства при оценке соответствующих StudentSubmissions
.
Ознакомьтесь со статьей о рубриках , чтобы узнать, как учителя могут использовать рубрики в классе.
Рубрики расширяют ресурс StudentSubmissions
дополнительными полями:
-
rubricId
идентифицирует рубрику, соответствующую представленнойCourseWork
. -
draftRubricGrades
представляет собой критерии и заполнители баллов, составленные учителем перед возвратом работы ученику. -
assignedRubricGrades
представляет собой критерии и баллы, которые получает ученик после того, как учитель возвращает работу.
Информацию о том, как управлять рубриками и читать связанные с ними оценки с помощью API, см. в руководстве по API рубрик.
Оценочные шкалы
Classroom поддерживает настраиваемые шкалы оценок , например, позволяя учителям переводить числовые оценки в буквенные. Эти настройки и соответствующие данные недоступны в API.