Method: courses.courseWorkMaterials.patch

Memperbarui satu atau beberapa kolom materi tugas kelas.

Metode ini menampilkan kode error berikut:

  • PERMISSION_DENIED jika project developer yang meminta akses error.
  • INVALID_ARGUMENT jika permintaan salah format.
  • FAILED_PRECONDITION jika materi tugas kursus yang diminta telah dihapus.
  • NOT_FOUND jika materi tugas atau kursus yang diminta tidak ada

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
courseId

string

ID kursus. ID ini dapat berupa ID yang ditetapkan Classroom atau alias.
id

string

ID materi tugas kursus.

Parameter kueri

Parameter
updateMask

string (FieldMask format)

Mask yang mengidentifikasi kolom pada materi tugas kelas yang akan diperbarui. Kolom ini wajib diisi untuk melakukan pembaruan. Pembaruan akan gagal jika kolom yang tidak valid ditentukan. Jika mendukung nilai kosong, kolom dapat dihapus dengan menentukannya dalam mask update dan bukan dalam objek materi tugas kelas. Jika kolom yang tidak mendukung nilai kosong disertakan dalam mask update dan tidak ditetapkan dalam objek materi tugas kelas, error INVALID_ARGUMENT akan ditampilkan.

Kolom berikut dapat ditentukan oleh pengajar:

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

Ini adalah comma-separated list berisi nama kolom yang sepenuhnya memenuhi syarat. Contoh: "user.displayName,photo".
previewVersion

enum (PreviewVersion)

Opsional. Versi pratinjau endpoint.

PREVIEW_VERSION_9001 mencakup kemampuan baru: * Pembaruan pada materi didukung. Untuk memperbarui materi, gunakan updateMask "materials". Daftar materi yang disediakan dalam objek CourseWorkMaterial permintaan akan sepenuhnya menggantikan daftar yang ada. Kolom materi dapat dihapus dengan menentukan "materi" di mask update dan tidak di objek CourseWorkMaterial. Pembaruan pada CourseWorkMaterial YANG DIPUBLIKASIKAN saat ini tidak didukung.

Isi permintaan

Isi permintaan memuat instance CourseWorkMaterial.

Isi respons

Jika berhasil, isi respons memuat instance CourseWorkMaterial.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.