Method: courses.courseWorkMaterials.patch

Memperbarui satu atau beberapa kolom materi tugas kursus.

Metode ini menampilkan kode error berikut:

  • PERMISSION_DENIED jika project developer yang meminta mengalami error akses.
  • INVALID_ARGUMENT jika permintaan salah format.
  • FAILED_PRECONDITION jika materi tugas kursus yang diminta telah dihapus.
  • NOT_FOUND jika kursus atau materi tugas 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 kursus yang akan diperbarui. Kolom ini wajib diisi untuk melakukan pembaruan. Pembaruan akan gagal jika kolom yang tidak valid ditentukan. Jika kolom mendukung nilai kosong, kolom tersebut dapat dikosongkan dengan menentukannya dalam mask pembaruan dan bukan dalam objek materi tugas kursus. Jika kolom yang tidak mendukung nilai kosong disertakan dalam mask pembaruan dan tidak ditetapkan dalam objek materi tugas kursus, error INVALID_ARGUMENT akan ditampilkan.

Kolom berikut dapat ditentukan oleh guru:

  • title
  • description
  • state
  • scheduledTime
  • topicId

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 dikosongkan dengan menentukan "materials" dalam mask pembaruan dan bukan dalam objek CourseWorkMaterial. Pembaruan pada CourseWorkMaterial yang DIPUBLIKASIKAN tidak didukung saat ini.

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.