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

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

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

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

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

Объекты StudentSubmission поддерживают поля, связанные с рубриками:

  • В дополнение к существующим свойствам draftGrade и assignedGrade , работа учащегося, оцененная по критерию, имеет свойства draftRubricGrades и assignedRubricGrades . Они представляют собой оценки по рубрикам (выбранные уровни и значения баллов), которые учащийся получает во время оценивания по рубрике, в состояниях черновика и назначенных соответственно.
  • На данный момент эти свойства доступны только для чтения. Это означает, что 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 считаются конфиденциальными и могут потребовать проверки вашего приложения.

Сторонние курсовые работы

Рубрики могут создаваться только проектом Google Cloud, в котором создан родительский элемент CourseWork . Это более широкий шаблон проектирования в Classroom API, который предотвращает влияние различных приложений на чужие ресурсы.

Это распространяется на ресурсы, созданные пользователями в приложении «Класс». Например, приложение не может управлять критериями курсовой работы, созданной преподавателем в пользовательском интерфейсе Класса, даже если приложение принадлежит тому же учителю. Если это существенно ограничивает ваш вариант использования, поделитесь отзывом в общедоступном трекере проблем .

Лицензионные требования

Пользователь может создавать, обновлять и удалять критерии с помощью Classroom API только при соблюдении следующих условий:

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