Если вы не знакомы с рубриками Classroom, ознакомьтесь с этими статьями Справочного центра, чтобы узнать об общей структуре рубрик и о том, как выполняется оценка рубрик в пользовательском интерфейсе Classroom.
Структура рубрик
Есть несколько важных концепций, которые стоит выделить при использовании API для взаимодействия с рубриками:
- С
CourseWork
связана (максимум) одна рубрика , и эта рубрика уникальна для этогоCourseWork
(она не может быть общей для всех ресурсовCourseWork
). - Рубрика состоит из критериев , которые состоят из уровней . Рубрика всегда должна иметь по крайней мере один критерий, а критерий всегда должен иметь по крайней мере один уровень.
- Уровни могут быть оценены (иметь баллы) или не оценены (нет баллов). Уровни должны быть полностью оценены или полностью не оценены в рубрике.
- Если уровни оцениваются, все уровни в критерии должны иметь уникальный набор значений баллов. Баллы могут быть целыми числами (например, 10) или значениями с плавающей точкой (например, 9,99). Это может включать 0. Нулевые значения не принимаются. Кроме того, рубрика не может иметь один критерий с одним уровнем, равным 0 баллам.
- Если уровни не оцениваются, поле баллов следует опустить; нулевые значения не принимаются.
- Порядок критериев и уровней имеет смысл и отражает порядок, в котором они представлены в пользовательском интерфейсе класса.
- В частности, оцениваемые уровни всегда должны сортироваться по баллам либо в порядке возрастания, либо в порядке убывания.
- В каждой рубрике может быть до 50 критериев и до 10 уровней эффективности в каждом критерии.
Сопутствующие поля для студенческих заявок
Объекты StudentSubmission
поддерживают поля, связанные с рубриками:
- В дополнение к существующим свойствам
draftGrade
иassignedGrade
, студенческая работа, оцененная с помощью рубрики, имеет свойстваdraftRubricGrades
иassignedRubricGrades
. Они представляют собой оценки рубрики (выбранные уровни и значения баллов), которые студент получает во время оценивания по рубрике, в черновике и назначенном состояниях соответственно. - На данный момент эти свойства доступны только для чтения. Это означает, что API не может использоваться для оценки отправленных работ , но вы можете читать отправленные работы, оцененные в пользовательском интерфейсе Classroom.
Рубрики поведения
API стремится по возможности копировать пользовательский интерфейс Classroom для обеспечения единообразия, но это может привести к поведению, которое может оказаться неинтуитивным для разработчиков, и о нем стоит упомянуть:
- Рубрики предназначены для руководства оцениванием, не ограничивая учителей. В результате, учитель может сделать следующее при оценке работы с рубрикой:
- Полностью игнорируйте критерии оценки.
- Переопределить баллы по критерию независимо от баллов, доступных на уровнях критерия.
- Выберите уровни только для подмножества критериев.
- Назначьте баллы по критерию, не выбирая соответствующий уровень.
- Переопределить общее количество баллов за задание, независимо от баллов, которые будут получены в результате проверки.
Кроме того, API не поддерживает поведение, которого еще нет в Classroom UI. Например, API не позволяет принудительно применять критерии оценки в заданиях или переопределять возможность учителя редактировать критерии оценки и материалы, как это возможно сегодня.
Ограничения при оценке
Аналогично, существуют некоторые дополнительные ограничения на редактирование рубрик после того, как учитель начал оценивать с их помощью. Только следующие правки возможны после оценки, как она началась:
- Разрешено редактирование текста заголовков и описаний критериев и уровней.
- Порядок уровней может меняться в пределах критериев.
Дополнительные области применения
Рубрики можно вручную экспортировать в Google Таблицы для повторного использования учителями.
Если вы создаете или обновляете рубрику из этих электронных таблиц (см. пример в руководстве ), ваше приложение должно запросить область https://www.googleapis.com/auth/spreadsheets.readonly
или https://www.googleapis.com/auth/spreadsheets
. Имейте в виду, что области spreadsheets
считаются конфиденциальными и могут потребовать проверки вашего приложения.
Курсовая работа третьих лиц
Рубрики могут быть созданы только проектом Google Cloud, который создал родительский элемент CourseWork
. Это более широкий шаблон проектирования в API Classroom, который не позволяет различным приложениям влиять на ресурсы, которые им не принадлежат.
Это распространяется на ресурсы, созданные пользователями в приложении Classroom. Например, приложение не может управлять критериями оценки для курсовой работы, созданной учителем в пользовательском интерфейсе Classroom, даже если этот же учитель владеет приложением. Если это существенно ограничивает ваш вариант использования, поделитесь отзывом в общедоступном трекере проблем .
Требования к лицензии
Пользователь может создавать, обновлять и удалять рубрики с помощью API Classroom только при соблюдении следующих условий:
- Пользователю, подавшему запрос, назначена лицензия Google Workspace for Education Plus .
- Владельцу соответствующего курса назначена лицензия Google Workspace for Education Plus .
Ознакомьтесь с требованиями к пользователям , чтобы узнать больше о том, как возможности API предоставляются пользователям, а также с предварительными условиями API для класса, чтобы ознакомиться с ними и запросить демонстрационную учетную запись для разработки.