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