Method: courses.courseWork.studentSubmissions.patch

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

Подробную информацию о том, какие поля можно обновлять и кто может их изменять, см. в файле google.classroom.v1.StudentSubmission

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

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

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

HTTP-запрос

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

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

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

Параметры
courseId

string

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

courseWorkId

string

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

id

string

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

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

Параметры
updateMask

string ( FieldMask format)

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

Учителя могут указать следующие поля:

  • draftGrade
  • assignedGrade

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

previewVersion

enum ( PreviewVersion )

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

Текст запроса

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

Ответный текст

В случае успеха тело ответа будет содержать экземпляр объекта StudentSubmission .

Области полномочий

Требуется один из следующих диапазонов аутентификации OAuth:

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

Для получения более подробной информации см. руководство по авторизации .