Method: courses.updateGradingPeriodSettings

• Permintaan HTTP
• Parameter lokasi
• Parameter kueri
• Isi permintaan
• Isi respons
• Cakupan otorisasi

Pratinjau Developer: Tersedia sebagai bagian dari Program Pratinjau Developer Google Workspace, yang memberikan akses awal ke fitur tertentu. Fitur ini tersedia di V1_20240401_PREVIEW dan yang lebih baru. Lihat Mengakses API Pratinjau untuk mempelajari lebih lanjut.

Memperbarui setelan periode penilaian kursus.

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