Method: courses.courseWork.patch

Memperbarui satu atau beberapa kolom tugas kursus.

Lihat google.classroom.v1.CourseWork untuk mengetahui detail kolom yang dapat diperbarui dan siapa yang dapat mengubahnya.

Permintaan ini harus dibuat oleh project Konsol Developer dari ID klien OAuth yang digunakan untuk membuat item tugas kursus yang sesuai.

Metode ini menampilkan kode error berikut:

  • PERMISSION_DENIED jika project developer yang meminta tidak membuat tugas kursus yang sesuai, jika pengguna tidak diizinkan untuk melakukan modifikasi yang diminta pada pengiriman siswa, atau untuk error akses.
  • INVALID_ARGUMENT jika permintaan salah format.
  • FAILED_PRECONDITION jika tugas kursus yang diminta telah dihapus.
  • NOT_FOUND jika kursus atau tugas kursus yang diminta tidak ada.

Permintaan HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{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 tugas kursus.

Parameter kueri

Parameter
updateMask

string (FieldMask format)

Mask yang mengidentifikasi kolom pada 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 di mask pembaruan dan bukan di objek CourseWork. Jika kolom yang tidak mendukung nilai kosong disertakan dalam mask pembaruan dan tidak ditetapkan dalam objek CourseWork, error INVALID_ARGUMENT akan ditampilkan.

Kolom berikut dapat ditentukan oleh pengajar:

  • title
  • description
  • state
  • dueDate
  • dueTime
  • maxPoints
  • scheduledTime
  • submissionModificationMode
  • topicId
  • gradingPeriodId
  • learningGoals

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

enum (PreviewVersion)

Opsional. Versi pratinjau API. Kolom ini harus ditetapkan agar dapat mengakses kemampuan API baru yang tersedia untuk developer dalam Program Pratinjau.

Isi permintaan

Isi permintaan memuat instance CourseWork.

Isi respons

Jika berhasil, isi respons memuat instance CourseWork.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

  • https://www.googleapis.com/auth/classroom.coursework.students

Untuk mengetahui informasi selengkapnya, lihat panduan Otorisasi.