Struktur rubrik dan batasan umum

Jika belum terbiasa dengan Rubrik Classroom, lihat artikel Pusat Bantuan berikut untuk mempelajari struktur umum rubrik dan cara penilaian rubrik dilakukan di UI Classroom.

Struktur rubrik

Ada beberapa konsep penting yang mungkin perlu disoroti saat menggunakan API untuk berinteraksi dengan rubrik:

  • Ada (maksimum) satu rubrik yang terkait dengan CourseWork dan rubrik tersebut bersifat unik untuk CourseWork tersebut (tidak dapat dibagikan di seluruh CourseWork resource).
  • Rubrik terdiri dari kriteria, yang terdiri dari level-level. Rubrik harus selalu memiliki setidaknya satu kriteria, dan kriteria harus selalu memiliki setidaknya satu tingkat.
  • Level dapat diberi skor (memiliki poin) atau tidak dinilai (tanpa poin). Tingkatan harus dinilai sepenuhnya atau tidak dinilai sama sekali dalam rubrik.
    • Jika level diberi skor, semua level dalam kriteria harus memiliki nilai poin yang unik. Points dapat berupa bilangan bulat (seperti 10) atau nilai floating point (seperti 9,99). Jumlah ini dapat mencakup 0. Nilai null tidak diterima. Selain itu, rubrik tidak boleh memiliki satu kriteria dengan satu tingkat yaitu 0 poin.
    • Jika levelnya tidak diberi skor, kolom poin harus dihilangkan; nilai null tidak diterima.
  • Urutan kriteria dan tingkat bersifat bermakna dan mencerminkan urutannya direpresentasikan di UI Classroom.
    • Level yang diberi skor secara khusus harus selalu diurutkan berdasarkan poin dengan urutan naik atau turun.
  • per rubrik dapat memiliki hingga 50 kriteria dan hingga 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. Ini mewakili nilai rubrik (tingkat yang dipilih dan nilai poin) yang diterima siswa selama penilaian dari rubrik, masing-masing dalam status draf dan status yang diberikan.
  • Untuk saat ini, properti ini bersifat hanya baca. Artinya, API ini tidak dapat digunakan untuk menilai kiriman, tetapi Anda dapat membaca kiriman yang diberi nilai 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 patut disebutkan:

  • Rubrik dimaksudkan untuk memandu penilaian tanpa membatasi pengajar. Oleh karena itu, pengajar dapat melakukan hal berikut saat menilai kiriman dengan rubrik:
    • Abaikan sepenuhnya rubrik saat memberi nilai.
    • Ganti titik untuk kriteria, apa pun titik yang tersedia di level kriteria.
    • Pilih tingkat hanya untuk sebagian kriteria.
    • Tetapkan poin untuk kriteria tanpa memilih tingkat yang sesuai.
    • Ganti poin total tugas, terlepas dari poin yang akan berasal dari rubrik.

Selain itu, API tersebut tidak memperkenalkan kemampuan produk baru. 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 yang diterapkan pada pengeditan rubrik setelah pengajar mulai memberi nilai dengan rubrik. Hanya pengeditan berikut yang dapat dilakukan setelah penilaian dimulai:

  • Pengeditan teks diperbolehkan untuk kriteria serta judul dan deskripsi tingkat.
  • Pengurutan tingkat dapat berubah dalam kriteria.

Cakupan tambahan

Rubrik dapat diekspor secara manual ke Google Spreadsheet untuk digunakan kembali oleh pengajar.

Jika Anda membuat atau memperbarui rubrik dari spreadsheet ini (lihat contoh dalam panduan), aplikasi Anda perlu 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.