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)

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

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

  • title
  • description
  • state
  • scheduledTime
  • topicId

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

previewVersion

enum ( PreviewVersion )

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

PREVIEW_VERSION_9001 добавлены новые возможности: * Поддерживается обновление материалов. Для обновления материалов используйте маску обновления "materials". Список материалов, предоставленный в объекте CourseWorkMaterial запроса, полностью заменит существующий список. Поле materials можно очистить, указав "materials" в маске обновления, а не в объекте CourseWorkMaterial . Обновление PUBLISHED CourseWorkMaterial в настоящее время не поддерживается.

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

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

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

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

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

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

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

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