Method: courses.updateGradingPeriodSettings

Memperbarui setelan periode penilaian kursus.

Masing-masing periode penilaian dapat ditambahkan, dihapus, atau diubah menggunakan metode ini.

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

Metode ini menampilkan kode error berikut:

  • PERMISSION_DENIED jika pengguna yang meminta tidak diizinkan untuk mengubah setelan periode penilaian di kursus atau karena error akses:
    • UserIneligibleToUpdateGradingPeriodSettings
  • INVALID_ARGUMENT jika permintaan memiliki format yang salah.
  • 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 ada dan data yang diubah dianggap sebagai hasil edit. Data yang tidak diubah akan dibiarkan apa adanya.
  • Periode penilaian yang disertakan dengan ID yang tidak dikenal akan menyebabkan error.

Kolom berikut dapat ditentukan:

  • gradingPeriods
  • applyToExistingCoursework

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