Struktur rubrik dan batasan umum

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 untuk CourseWork tersebut (tidak dapat dibagikan di seluruh resource CourseWork).
  • 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.

Objek Kiriman siswa juga berubah:

  • Selain properti draftGrade dan assignedGrade yang ada, kiriman siswa yang dinilai dengan rubrik memiliki properti draftRubricGrades dan assignedRubricGrades. 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 dengan CourseWork, 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.