Jika tidak terbiasa dengan Rubrik Classroom, lihat artikel Pusat Bantuan ini untuk mempelajari struktur umum rubrik dan cara pemberian nilai rubrik dilakukan di UI Classroom.
Struktur rubrik
Ada beberapa konsep penting yang mungkin perlu disoroti saat menggunakan API untuk berinteraksi dengan rubrik:
- Ada (maksimal) satu rubrik yang terkait dengan
CourseWork
dan rubrik tersebut bersifat unik untukCourseWork
tersebut (tidak dapat dibagikan di seluruh resourceCourseWork
). - Rubrik ini terdiri dari kriteria yang terdiri dari tingkat. Rubrik harus selalu memiliki minimal satu kriteria, dan kriteria harus selalu memiliki minimal satu level.
- Level dapat diberi skor (memiliki poin) atau tanpa skor (tidak ada poin). Tingkat harus
sepenuhnya diberi skor atau sepenuhnya tidak diberi skor dalam rubrik.
- Jika level diberi skor, semua level dalam kriteria harus memiliki nilai poin yang unik. Titik dapat berupa bilangan bulat (seperti 10) atau nilai titik mengambang (seperti 9,99). Nilai ini dapat mencakup 0. Nilai null tidak diterima. Selain itu, rubrik tidak boleh memiliki satu kriteria dengan satu level yang bernilai 0 poin.
- Jika tingkat tidak diberi skor, kolom poin harus dihilangkan; nilai null tidak diterima.
- Urutan kriteria dan tingkat bersifat penting dan mencerminkan urutan
kriteria dan tingkat yang direpresentasikan di UI Classroom.
- Secara khusus, level yang diberi skor harus selalu diurutkan berdasarkan poin dalam urutan naik atau turun.
- Jumlahnya bisa mencapai hingga 50 kriteria per rubrik dan maksimal 10 tingkat performa per kriteria.
Kolom kiriman siswa terkait
Objek Kiriman siswa juga berubah:
- Selain properti
draftGrade
danassignedGrade
yang ada, kiriman siswa yang dinilai dengan rubrik memiliki propertidraftRubricGrades
danassignedRubricGrades
. Nilai ini mewakili nilai rubrik (tingkat yang dipilih dan nilai poin) yang diterima siswa selama penilaian dari rubrik, masing-masing dalam status draf dan ditugaskan. - Untuk saat ini, properti ini hanya dapat dibaca. Artinya, API tidak dapat digunakan untuk menilai kiriman, tetapi Anda dapat membaca kiriman yang dinilai di UI Classroom.
- Kiriman siswa dengan rubrik terkait berisi kolom
rubricId
. Kolom ini mewakili rubrik terbaru yang terkait denganCourseWork
, dan nilai ini dapat berubah jika pengajar menghapus dan membuat ulang rubrik.
Perilaku rubrik
API ini bertujuan untuk mencerminkan UI Classroom jika memungkinkan untuk konsistensi, tetapi hal ini dapat menyebabkan perilaku yang mungkin tidak intuitif bagi developer dan perlu disebutkan:
- Rubrik dimaksudkan untuk memandu penilaian tanpa membatasi pengajar. Oleh karena itu, pengajar dapat melakukan hal berikut saat menilai kiriman dengan
rubrika:
- Abaikan sepenuhnya rubrik saat menilai.
- Ganti poin untuk kriteria, terlepas dari poin yang tersedia di tingkat kriteria.
- Pilih tingkat hanya untuk sebagian kriteria.
- Tetapkan poin untuk kriteria tanpa memilih tingkat yang sesuai.
- Ganti total poin tugas, terlepas dari poin yang akan berasal dari rubrik.
Selain itu, API ini tidak memperkenalkan kemampuan produk baru apa pun. Dengan kata lain, API tidak mendukung perilaku yang belum dimiliki UI Classroom. Misalnya, API tidak memungkinkan penerapan penggunaan rubrik pada tugas atau mengganti kemampuan pengajar untuk mengedit rubrik dan kiriman seperti yang dapat dilakukan saat ini.
Batasan selama penilaian
Demikian pula, ada beberapa batasan tambahan untuk mengedit rubrik setelah guru mulai memberikan nilai dengan rubrik tersebut. Hanya pengeditan berikut yang dapat dilakukan setelah pemberian nilai dimulai:
- Pengeditan teks diizinkan untuk judul dan deskripsi kriteria serta level.
- Urutan tingkat dapat berubah dalam kriteria.
Cakupan tambahan
Rubrik dapat diekspor secara manual ke Google Spreadsheet untuk digunakan kembali oleh guru.
Jika Anda membuat atau memperbarui rubrik dari spreadsheet ini (lihat contoh dalam
panduan), aplikasi Anda harus meminta cakupan
https://www.googleapis.com/auth/spreadsheets.readonly
atau
https://www.googleapis.com/auth/spreadsheets
. Perhatikan bahwa cakupan spreadsheets
dianggap sensitif dan mungkin mengharuskan aplikasi Anda diverifikasi.