Method: courses.updateGradingPeriodSettings

Memperbarui setelan periode penilaian kursus.

Pengguna yang meminta dan pemilik kursus harus memenuhi syarat untuk mengubah Periode Penilaian. Untuk detailnya, lihat persyaratan pemberian lisensi.

Metode ini akan menampilkan kode error berikut:

  • PERMISSION_DENIED jika pengguna yang meminta tidak diizinkan untuk mengubah setelan periode penilaian dalam kursus atau untuk error akses:
    • UserIneligibleToUpdateGradingPeriodSettings
  • INVALID_ARGUMENT jika permintaan salah format.
  • NOT_FOUND jika kursus yang diminta tidak ada.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
courseId

string

Wajib. ID kursus.

Parameter kueri

Parameter
updateMask

string (FieldMask format)

Mask yang mengidentifikasi kolom mana di GradingPeriodSettings yang akan diperbarui.

Daftar gradingPeriods GradingPeriodSettings akan sepenuhnya diganti dengan periode penilaian yang ditentukan dalam permintaan pembaruan. Contoh:

  • Periode penilaian yang disertakan dalam daftar tanpa ID dianggap sebagai penambahan, dan ID baru akan ditetapkan saat permintaan dibuat.
  • Periode penilaian yang saat ini ada, tetapi tidak ada dalam permintaan akan dianggap sebagai penghapusan.
  • Periode penilaian dengan ID yang sudah ada dan data yang diubah dianggap sebagai hasil edit. Data yang tidak dimodifikasi akan dibiarkan apa adanya.
  • Periode penilaian yang disertakan dengan ID yang tidak diketahui akan menyebabkan error.

Kolom berikut dapat ditentukan:

  • gradingPeriods
  • applyToExistingCoursework

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 GradingPeriodSettings.

Isi respons

Jika berhasil, isi respons memuat instance GradingPeriodSettings.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Panduan otorisasi.