Method: courses.courseWork.rubrics.patch

Обновляет рубрику.

Подробную информацию о том, какие поля можно обновлять, см. в google.classroom.v1.Rubric . Возможности обновления рубрик ограничены после начала оценивания.

Этот запрос должен быть сделан с помощью консоли Google Cloud с идентификатором клиента OAuth , который использовался для создания родительского рабочего элемента курса.

Этот метод возвращает следующие коды ошибок:

  • PERMISSION_DENIED если запрашивающий проект разработчика не создал соответствующую курсовую работу, если пользователю не разрешено вносить запрошенные изменения в рубрику или в случае ошибок доступа . Этот код ошибки также возвращается, если оценивание по данному критерию уже началось.
  • INVALID_ARGUMENT , если запрос имеет неверный формат и следующая ошибка запроса :
    • RubricCriteriaInvalidFormat
  • NOT_FOUND если запрошенный курс, курсовая работа или рубрика не существует или если у пользователя нет доступа к соответствующей курсовой работе.
  • INTERNAL , если оценивание по данной рубрике уже началось.

HTTP-запрос

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/rubrics/{id}

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
courseId

string

Необходимый. Идентификатор курса.

courseWorkId

string

Необходимый. Идентификатор курсовой работы.

id

string

Необязательный. Идентификатор рубрики.

Параметры запроса

Параметры
updateMask

string ( FieldMask format)

Необязательный. Маска, определяющая, какие поля рубрики необходимо обновить. Это поле необходимо для обновления. Обновление завершается неудачно, если указаны недопустимые поля. Существует несколько вариантов определения критериев рубрики: sourceSpreadsheetId и список criteria . Для определения рубрики одновременно можно использовать только один из них.

Список criteria рубрики полностью заменяется критериями рубрики, указанными в запросе на обновление. Например, если в запросе отсутствует критерий или уровень, он удаляется. Добавляются новые критерии и уровни и присваивается идентификатор. Существующие критерии и уровни сохраняют ранее назначенный идентификатор, если идентификатор указан в запросе.

Преподаватели могут указать следующие поля:

  • criteria
  • sourceSpreadsheetId

Это разделенный запятыми список полных имен полей. Пример: "user.displayName,photo" .

previewVersion

enum ( PreviewVersion )

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

Тело запроса

Тело запроса содержит экземпляр Rubric .

Тело ответа

В случае успеха тело ответа содержит экземпляр Rubric .

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/classroom.coursework.students

Дополнительную информацию см. в руководстве по авторизации .