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

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

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

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

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

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

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

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

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

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

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

Ограничения при оценке

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

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

Дополнительные области применения

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

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

Курсовая работа третьих лиц

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

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

Требования к лицензии

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

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

Назад
Оценочные периоды