Method: courses.courseWork.patch

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

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

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

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

  • PERMISSION_DENIED if the requesting developer project did not create the corresponding course work, if the user is not permitted to make the requested modification to the student submission, or for access errors .
  • 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)

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

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

  • 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

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