Структура рубрик и известные ограничения

Если вы не знакомы с рубриками 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 только при соблюдении следующих условий:

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