Method: courses.updateGradingPeriodSettings

Обновляет настройки оценивания курса.

С помощью этого метода можно добавлять, удалять или изменять отдельные оценочные периоды.

Запрашивающий пользователь и владелец курса должны иметь право изменять оценочные периоды. Подробности см. в лицензионных требованиях .

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

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

HTTP-запрос

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/gradingPeriodSettings

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

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

Параметры
courseId

string

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

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

Параметры
updateMask

string ( FieldMask format)

Маска, определяющая, какие поля в GradingPeriodSettings необходимо обновить.

Список GradingPeriodSettings gradingPeriods будет полностью заменен периодами оценивания, указанными в запросе на обновление. Например:

  • Оценочные периоды, включенные в список без идентификатора, считаются дополнительными, и при подаче запроса будет присвоен новый идентификатор.
  • Оценочные периоды, которые существуют в настоящее время, но отсутствуют в запросе, будут считаться удаленными.
  • Периоды оценивания с существующим идентификатором и измененными данными считаются изменениями. Немодифицированные данные останутся как есть.
  • Оценочные периоды, включенные с неизвестным идентификатором, приведут к ошибке.

Могут быть указаны следующие поля:

  • gradingPeriods
  • applyToExistingCoursework

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

previewVersion

enum ( PreviewVersion )

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

Тело запроса

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

Тело ответа

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

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

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

  • https://www.googleapis.com/auth/classroom.courses

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