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

Если вы не знакомы с рубриками Класса, прочтите эти статьи Справочного центра, чтобы узнать об общей структуре критерия и о том, как оценивается критерий в пользовательском интерфейсе Класса.

Структура рубрик

Есть несколько важных концепций, которые, возможно, стоит подчеркнуть при использовании API для взаимодействия с рубриками:

  • Существует (максимум) одна рубрика , связанная с CourseWork , и эта рубрика уникальна для этой CourseWork (она не может быть использована совместно другими ресурсами CourseWork ).
  • Рубрика состоит из критериев , которые состоят из уровней . Рубрика всегда должна иметь хотя бы один критерий, а критерий всегда должен иметь хотя бы один уровень.
  • Уровни могут быть зачетными (есть очки) или неоцененными (без очков). Уровни должны быть полностью оценены или полностью не оценены в рамках рубрики.
    • Если уровни оцениваются, для всех уровней критерия должно быть установлено уникальное значение баллов. Точки могут быть целыми числами (например, 10) или значениями с плавающей запятой (например, 9,99). Это может быть 0. Нулевые значения не принимаются. Кроме того, в рубрике не может быть одного критерия с одним уровнем, равным 0 баллов.
    • Если уровни не оцениваются, поле очков следует опустить; нулевые значения не принимаются.
  • Порядок критериев и уровней имеет смысл и отражает порядок их представления в пользовательском интерфейсе Класса.
    • В частности, набранные уровни всегда должны сортироваться по очкам в порядке возрастания или убывания.
  • В каждой рубрике может быть до 50 критериев и до 10 уровней эффективности для каждого критерия.

Объекты подачи заявок учащихся также меняются:

  • В дополнение к существующим свойствам draftGrade и assignedGrade , работа учащегося, оцененная по критерию, имеет свойства draftRubricGrades и assignedRubricGrades . Они представляют собой оценки по рубрикам (выбранные уровни и значения баллов), которые учащийся получает во время выставления оценок по рубрике, в состояниях черновика и назначенных соответственно.
  • На данный момент эти свойства доступны только для чтения. Это означает, что API нельзя использовать для оценки отправленных работ , но вы можете читать оцененные работы в пользовательском интерфейсе Класса.
  • Работы учащихся со связанной рубрикой содержат поле rubricId . Это поле представляет последнюю рубрику, связанную с CourseWork , и это значение может измениться, если преподаватели удалят и заново создадут рубрику.

Рубрики поведения

API стремится по возможности отражать пользовательский интерфейс Класса для обеспечения единообразия, но это может привести к поведению, которое может быть неинтуитивным для разработчиков и о котором стоит упомянуть:

  • Рубрики предназначены для управления выставлением оценок, не ограничивая учителей. В результате преподаватель может сделать следующее при оценке работы по критериям:
    • Полностью игнорируйте критерии при выставлении оценок.
    • Переопределить баллы для критерия, независимо от количества баллов, доступных на уровнях критерия.
    • Выбирайте уровни только для подмножества критериев.
    • Назначайте баллы по критерию, не выбирая соответствующий уровень.
    • Переопределить общее количество баллов за задание, независимо от баллов, полученных из рубрики.

Кроме того, API не предоставляет никаких новых возможностей продукта. Другими словами, API не поддерживает поведение, которого еще нет в пользовательском интерфейсе Класса . Например, API не позволяет принудительно использовать рубрики в заданиях или переопределять возможность учителя редактировать рубрики и материалы, как это возможно сегодня.

Ограничения во время оценивания

Аналогичным образом, существуют некоторые дополнительные ограничения на редактирование рубрик после того, как учитель начал выставлять оценки по ним. После начала оценивания возможны только следующие изменения:

  • Текстовое редактирование разрешено для заголовков и описаний критериев и уровней.
  • Порядок уровней может меняться в пределах критериев.

Дополнительные возможности

Рубрики можно вручную экспортировать в таблицы Google для повторного использования учителями.

Если вы создаете или обновляете критерий на основе этих таблиц (см. пример в руководстве ), вашему приложению необходимо запросить https://www.googleapis.com/auth/spreadsheets.readonly или https://www.googleapis.com/auth/spreadsheets . Область https://www.googleapis.com/auth/spreadsheets . Имейте в виду, что области spreadsheets считаются конфиденциальными и могут потребовать проверки вашего приложения.