Method: courses.courseWork.patch

Обновляет одно или несколько полей курсовой работы.

См. google.classroom.v1.CourseWork , чтобы узнать, какие поля можно обновлять и кто может их изменять.

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

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

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

HTTP-запрос

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

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

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

Параметры
courseId

string

Идентификатор курса. Этот идентификатор может быть либо идентификатором, присвоенным Классом, либо alias .

id

string

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

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

Параметры
updateMask

string ( FieldMask format)

Маска, определяющая, какие поля курса необходимо обновить. Это поле необходимо для обновления. Обновление завершается неудачно, если указаны недопустимые поля. Если поле поддерживает пустые значения, его можно очистить, указав его в маске обновления, а не в объекте CourseWork . Если поле, не поддерживающее пустые значения, включено в маску обновления и не задано в объекте CourseWork , возвращается ошибка INVALID_ARGUMENT .

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

  • title
  • description
  • state
  • dueDate
  • dueTime
  • maxPoints
  • scheduledTime
  • submissionModificationMode
  • topicId
  • gradingPeriodId Доступно в версии V1_20240401_PREVIEW и более поздних версиях.

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

previewVersion

enum ( PreviewVersion )

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

Тело запроса

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

Тело ответа

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

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

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

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

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