Method: courses.courseWork.patch

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

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

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

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

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

HTTP-запрос

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

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

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

Параметры
courseId

string

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

id

string

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

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

Параметры
updateMask

string ( FieldMask format)

Mask that identifies which fields on the course work to update. This field is required to do an update. The update fails if invalid fields are specified. If a field supports empty values, it can be cleared by specifying it in the update mask and not in the CourseWork object. If a field that does not support empty values is included in the update mask and not set in the CourseWork object, an INVALID_ARGUMENT error is returned.

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

  • title
  • description
  • state
  • dueDate
  • dueTime
  • maxPoints
  • scheduledTime
  • submissionModificationMode
  • topicId
  • gradingPeriodId
  • learningGoals

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

previewVersion

enum ( PreviewVersion )

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

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

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

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

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

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

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

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

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