Method: courses.courseWork.patch

Memperbarui satu atau beberapa kolom tugas kursus.

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

Permintaan ini harus dibuat oleh proyek Konsol Developer client ID OAuth yang digunakan untuk membuat item tugas kursus yang sesuai.

Metode ini akan 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 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 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 mana pada tugas kursus yang akan diperbarui. Kolom ini wajib diisi untuk melakukan update. Update gagal jika kolom yang tidak valid ditentukan. Jika kolom mendukung nilai kosong, kolom tersebut dapat dihapus dengan menentukannya dalam mask update, bukan dalam objek CourseWork. Jika kolom yang tidak mendukung nilai kosong disertakan dalam mask update 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 yang dipisahkan koma yang berisi nama kolom yang sepenuhnya memenuhi syarat. Contoh: "user.displayName,photo".
previewVersion

enum (PreviewVersion)

Opsional. Versi pratinjau API. Ini harus disetel agar dapat mengakses kemampuan API baru yang tersedia bagi developer dalam Program Pratinjau.

Isi permintaan

Isi permintaan memuat instance CourseWork.

Isi respons

Jika berhasil, isi respons akan berisi instance CourseWork.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Panduan otorisasi.