Add-on Google Classroom kini tersedia secara umum untuk developer. Lihat
dokumentasi add-on untuk informasi selengkapnya.
Method: courses.updateGradingPeriodSettings
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:
gradingPeriodsapplyToExistingCoursework 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.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2024-12-05 UTC.
[null,null,["Terakhir diperbarui pada 2024-12-05 UTC."],[[["Updates a course's grading period settings, requiring eligibility to modify them by both the requesting user and course owner."],["The request must include a field mask to specify which fields of the GradingPeriodSettings are to be updated, potentially adding, deleting, or editing grading periods."],["The API uses a PATCH request to `https://classroom.googleapis.com/v1/courses/{courseId}/gradingPeriodSettings`, where `{courseId}` is replaced with the specific course identifier."],["Potential errors include `PERMISSION_DENIED`, `INVALID_ARGUMENT`, and `NOT_FOUND` based on user permissions, request validity, and course existence."],["Authorization requires the `https://www.googleapis.com/auth/classroom.courses` OAuth scope."]]],[]]
