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

Если вы не знакомы с критериями оценивания в 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 . Это более широкий принцип проектирования в API Classroom, который предотвращает влияние различных приложений на ресурсы, не принадлежащие им.

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

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

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

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

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