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 Play dari client ID 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 perubahan yang diminta pada kiriman siswa, atau karena error akses.
  • INVALID_ARGUMENT jika permintaan memiliki format yang salah.
  • 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 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 di tugas kursus yang akan diperbarui. Kolom ini wajib diisi untuk melakukan pembaruan. Pembaruan akan gagal jika kolom yang ditentukan tidak valid. Jika mendukung nilai kosong, kolom dapat dihapus dengan menentukannya di mask pembaruan, 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 Tersedia di V1_20240401_PREVIEW dan yang lebih baru.

Ini adalah daftar dipisahkan koma yang berisi nama-nama kolom yang sepenuhnya memenuhi syarat. Contoh: "user.displayName,photo".
previewVersion

enum (PreviewVersion)

Opsional. Versi pratinjau API. Ini harus ditetapkan untuk mengakses kemampuan API baru yang tersedia bagi developer di 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 informasi selengkapnya, lihat Panduan otorisasi.