Struktur rubrik dan batasan umum

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

Struktur rubrik

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

  • Hanya ada (maksimal) satu rubrik yang terkait dengan CourseWork dan rubrik itu unik untuk CourseWork tersebut (tidak dapat dibagikan di seluruh resource CourseWork).
  • Rubrik ini terdiri dari kriteria yang terdiri dari tingkat. Rubrik harus selalu memiliki setidaknya satu kriteria, dan sebuah kriteria harus selalu memiliki setidaknya pada satu tingkat.
  • Level dapat diberi skor (memiliki poin) atau tanpa skor (tidak ada poin). Level harus diberi skor sepenuhnya atau sama sekali tidak dinilai dalam sebuah rubrik.
    • Jika level diberi skor, semua level dalam kriteria harus memiliki nilai poin ditetapkan. Poin dapat berupa bilangan bulat (seperti 10) atau 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 yakni 0 poin.
    • Jika tingkat tidak diberi skor, kolom poin harus dihilangkan; null (kosong) nilai tersebut tidak diterima.
  • Urutan kriteria dan tingkat bersifat bermakna dan mencerminkan urutannya ditampilkan di UI Classroom.
    • Secara khusus, level yang dinilai harus selalu diurutkan berdasarkan poin urutan naik atau turun.
  • Maksimum 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 draftRubricGrades dan Properti assignedRubricGrades. Ini mewakili nilai rubrik (tingkat dipilih dan nilai poin) yang diterima siswa selama penilaian dari rubrik, masing-masing di draf dan keadaan yang ditetapkan.
  • Untuk saat ini, properti ini bersifat hanya baca. Ini berarti API tidak dapat digunakan untuk menilai kiriman, namun 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 mencerminkan UI Classroom jika memungkinkan demi konsistensi, tetapi hal ini dapat menyebabkan perilaku yang mungkin tidak intuitif bagi developer dan bermanfaat menyebutkan:

  • Rubrik dimaksudkan untuk memandu penilaian tanpa membatasi pengajar. Sebagai seorang hasil tersebut, guru dapat melakukan hal berikut saat menilai kiriman dengan rubrik:
    • Abaikan sepenuhnya rubrik saat menilai.
    • Mengganti poin untuk kriteria, apa pun poinnya yang tersedia di tingkat kriteria.
    • Pilih tingkat hanya untuk sebagian kriteria.
    • Tetapkan poin untuk kriteria tanpa memilih level yang sesuai.
    • Ganti total poin tugas, terlepas dari poin yang berasal dari rubrik.

Selain itu, API tersebut tidak memperkenalkan kemampuan produk baru. Di kata, 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 sebagaimana mereka sekarang juga.

Batasan selama penilaian

Demikian pula, ada beberapa batasan tambahan pada pengeditan rubrik setelah pengajar mulai menilai dengan alat tersebut. Hanya pengeditan berikut yang dapat dilakukan setelah penilaian sebagai dimulai:

  • Pengeditan teks diperbolehkan untuk judul dan deskripsi tingkat serta kriteria.
  • Urutan level dapat berubah berdasarkan 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 di ), aplikasi Anda perlu meminta https://www.googleapis.com/auth/spreadsheets.readonly atau Cakupan https://www.googleapis.com/auth/spreadsheets. Perlu diketahui bahwa Cakupan spreadsheets dianggap sensitif dan mungkin memerlukan aplikasi Anda diverifikasi.