Method: courses.updateGradingPeriodSettings
Обновляет настройки оценивания курса.
Запрашивающий пользователь и владелец курса должны иметь право изменять оценочные периоды. Подробности см. в лицензионных требованиях .
Этот метод возвращает следующие коды ошибок:
-
PERMISSION_DENIED , если запрашивающему пользователю не разрешено изменять настройки оценочного периода в курсе или в случае ошибок доступа :- Усеринелигиблетоупдатеградингпериодсеттингс
-
INVALID_ARGUMENT , если запрос имеет неверный формат. -
NOT_FOUND , если запрошенный курс не существует.
HTTP-запрос
PATCH https://classroom.googleapis.com/v1/courses/{courseId}/gradingPeriodSettings
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
| Параметры |
|---|
course Id | string Необходимый. Идентификатор курса. |
Параметры запроса
| Параметры |
|---|
update Mask | string ( FieldMask format) Маска, определяющая, какие поля в GradingPeriodSettings необходимо обновить. Список GradingPeriodSettings gradingPeriods будет полностью заменен периодами оценивания, указанными в запросе на обновление. Например: - Оценочные периоды, включенные в список без идентификатора, считаются дополнительными, и при подаче запроса будет присвоен новый идентификатор.
- Оценочные периоды, которые существуют в настоящее время, но отсутствуют в запросе, будут считаться удаленными.
- Периоды оценивания с существующим идентификатором и измененными данными считаются изменениями. Немодифицированные данные останутся как есть.
- Оценочные периоды, включенные с неизвестным идентификатором, приведут к ошибке.
Могут быть указаны следующие поля: -
gradingPeriods -
applyToExistingCoursework
Это разделенный запятыми список полных имен полей. Пример: "user.displayName,photo" . |
preview Version | enum ( PreviewVersion ) Необязательный. Предварительная версия API. Это необходимо настроить, чтобы получить доступ к новым возможностям API, доступным разработчикам в программе предварительной версии. |
Тело запроса
Тело запроса содержит экземпляр GradingPeriodSettings .
Тело ответа
В случае успеха тело ответа содержит экземпляр GradingPeriodSettings .
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/classroom.courses
Дополнительную информацию см. в руководстве по авторизации .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-12-05 UTC.
[null,null,["Последнее обновление: 2024-12-05 UTC."],[[["Updates a course's grading period settings, requiring eligibility to modify them by both the requesting user and course owner."],["The request must include a field mask to specify which fields of the GradingPeriodSettings are to be updated, potentially adding, deleting, or editing grading periods."],["The API uses a PATCH request to `https://classroom.googleapis.com/v1/courses/{courseId}/gradingPeriodSettings`, where `{courseId}` is replaced with the specific course identifier."],["Potential errors include `PERMISSION_DENIED`, `INVALID_ARGUMENT`, and `NOT_FOUND` based on user permissions, request validity, and course existence."],["Authorization requires the `https://www.googleapis.com/auth/classroom.courses` OAuth scope."]]],[]]
