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

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

Структура критериев оценки

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

  • Для каждой CourseWork существует (максимум) одна рубрика , и эта рубрика уникальна для данной CourseWork (она не может быть использована для других CourseWork ).
  • Рубрика состоит из критериев , которые, в свою очередь, состоят из уровней . Рубрика всегда должна содержать как минимум один критерий, а критерий всегда должен иметь как минимум один уровень.
  • Уровни могут оцениваться баллами (начисляются баллы) или не оцениваться (баллы не начисляются). В рамках критериев оценки уровни должны быть либо полностью оценены, либо полностью не оценены.
    • If the levels are scored, all levels in a criterion must have a unique points value set. Points can be integers (like 10) or floating point values (like 9.99). This can include 0. Null values are not accepted. Additionally, a rubric can't have a single criteria with a single level that is 0 points.
    • Если уровни не оцениваются, поле с баллами следует опустить; нулевые значения не принимаются.
  • Порядок критериев и уровней имеет смысл и отражает порядок их отображения в пользовательском интерфейсе класса.
    • В частности, уровни, по которым начисляются баллы, всегда должны быть отсортированы по возрастанию или убыванию количества баллов.
  • В каждой рубрике может быть до 50 критериев и до 10 уровней выполнения для каждого критерия.

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

  • In addition to the existing draftGrade and assignedGrade properties, a student submission graded with a rubric has draftRubricGrades and assignedRubricGrades properties. These represent the rubric grades (levels selected and point values) the student receives during grading from the rubric, in the draft and assigned states, respectively.
  • На данный момент эти свойства доступны только для чтения. Это означает, что API нельзя использовать для оценивания работ , но вы можете читать работы, оцененные в пользовательском интерфейсе Classroom.

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

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

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

Additionally, the API doesn't support behavior the Classroom UI doesn't already have. For example, the API doesn't enable enforcing rubrics usage on assignments or overriding a teacher's ability to edit rubrics and submissions as they can today.

Ограничения при выставлении оценок

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

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

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

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

If you create or update a rubric from these spreadsheets (see an example in the guide ), your application needs to request the https://www.googleapis.com/auth/spreadsheets.readonly or https://www.googleapis.com/auth/spreadsheets scope. Be aware that the spreadsheets scopes are considered sensitive and may require your application to be verified .

Курсы, выполненные сторонними организациями.

Rubrics can only be created by the Google Cloud project that created the parent CourseWork item. This is a broader design pattern in the Classroom API which prevents different applications from impacting resources that aren't thiers.

This extends to resources created by users in the Classroom app. For example, It's not possible for an application to manage rubrics for a coursework that a teacher created in the Classroom UI, even if the same teacher owns the application. If this significantly limits your use case, share feedback in the public issue tracker .

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

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

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