Дополнения Google Classroom теперь общедоступны для разработчиков! Дополнительную информацию см. в документации по дополнениям .

Эта страница переведена с помощью Cloud Translation API.

Оценки

В этом документе представлены концепции оценивания, относящиеся к 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.

Шкалы оценок

Класс поддерживает настраиваемые шкалы оценок , позволяя учителям, например, переводить числовые оценки в буквенные. Эти настройки и соответствующие данные недоступны в API.

Структура API

Типы пользователей