Method: courses.courseWorkMaterials.patch

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

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

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

HTTP-запрос

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

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

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

Параметры
courseId

string

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

id

string

Идентификатор учебных материалов.

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

Параметры
updateMask

string ( FieldMask format)

Mask that identifies which fields on the course work material 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 course work material object. If a field that does not support empty values is included in the update mask and not set in the course work material object, an INVALID_ARGUMENT error is returned.

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

  • title
  • description
  • state
  • scheduledTime
  • topicId
  • learningGoals

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

previewVersion

enum ( PreviewVersion )

Необязательно. Предварительная версия конечной точки.

PREVIEW_VERSION_9001 includes new capabilities: * Updates to materials are supported. To update materials, use the updateMask "materials". The list of materials provided in the request's CourseWorkMaterial object will fully replace the existing list. The materials field can be cleared by specifying "materials" in the update mask and not in the CourseWorkMaterial object. Updates to PUBLISHED CourseWorkMaterial are not supported at this time.

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

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

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

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

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

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

  • https://www.googleapis.com/auth/classroom.courseworkmaterials

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