Struktur rubrik dan batasan umum

Jika Anda belum memahami Rubrik Classroom, lihat artikel Pusat Bantuan ini untuk mempelajari struktur umum rubrik dan cara penilaian rubrik dilakukan di UI Classroom.

Struktur rubrik

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

  • Ada (paling banyak) satu rubrik yang terkait dengan CourseWork dan rubrik tersebut unik untuk CourseWork tersebut (tidak dapat dibagikan di seluruh resource CourseWork).
  • Rubrik terdiri dari kriteria, yang terdiri dari level. Rubrik harus selalu memiliki minimal satu kriteria, dan kriteria harus selalu memiliki minimal satu level.
  • Tingkat dapat dinilai (memiliki poin) atau tidak dinilai (tidak memiliki poin). Tingkat harus seluruhnya diberi skor atau seluruhnya tidak diberi skor dalam rubrik.
    • Jika level diberi skor, semua level dalam kriteria harus memiliki nilai poin unik yang ditetapkan. Poin dapat berupa bilangan bulat (seperti 10) atau nilai floating point (seperti 9,99). Hal ini dapat mencakup 0. Nilai null tidak diterima. Selain itu, rubrik tidak boleh memiliki satu kriteria dengan satu tingkat yang bernilai 0 poin.
    • Jika level tidak diberi skor, kolom poin harus dihilangkan; nilai null tidak diterima.
  • Urutan kriteria dan tingkat memiliki arti dan mencerminkan urutan yang ditampilkan di UI Classroom.
    • Level yang diberi skor khususnya harus selalu diurutkan berdasarkan poin dalam urutan menaik atau menurun.
  • Dapat tersedia hingga 50 kriteria per rubrik dan maksimal 10 tingkat performa per kriteria.

Objek StudentSubmission mendukung kolom terkait rubrik:

  • 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, dalam status draf dan ditugaskan.
  • Untuk saat ini, properti ini bersifat hanya baca. Artinya, API tidak dapat digunakan untuk menilai kiriman, tetapi Anda dapat membaca kiriman yang dinilai di UI Classroom.

Perilaku rubrik

API ini bertujuan untuk mencerminkan UI Classroom jika memungkinkan demi konsistensi, tetapi hal ini dapat menyebabkan perilaku yang mungkin tidak intuitif bagi developer dan perlu disebutkan:

  • Rubrik dimaksudkan untuk memandu penilaian tanpa membatasi pengajar. Sebagai hasilnya, pengajar dapat melakukan hal berikut saat menilai kiriman dengan rubrik:
    • Mengabaikan rubrik sepenuhnya saat memberi nilai.
    • Ganti poin untuk kriteria, terlepas dari poin yang tersedia di tingkat kriteria.
    • Pilih tingkat hanya untuk sebagian kriteria.
    • Menetapkan poin untuk kriteria tanpa memilih tingkat yang sesuai.
    • Ganti total poin tugas, terlepas dari poin yang akan berasal dari rubrik.

Selain itu, API tidak mendukung perilaku yang belum ada di UI Classroom. Misalnya, API tidak memungkinkan penerapan penggunaan rubrik pada tugas atau menggantikan kemampuan pengajar untuk mengedit rubrik dan kiriman seperti yang dapat mereka lakukan saat ini.

Batasan selama penilaian

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

  • Pengeditan teks diizinkan untuk judul dan deskripsi kriteria dan tingkat.
  • Urutan 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.

Kursus pihak ketiga

Rubrik hanya dapat dibuat oleh project Google Cloud yang membuat item CourseWork induk. Ini adalah pola desain yang lebih luas di Classroom API yang mencegah aplikasi yang berbeda memengaruhi resource yang bukan miliknya.

Hal ini mencakup resource yang dibuat oleh pengguna di aplikasi Classroom. Misalnya, aplikasi tidak dapat mengelola rubrik untuk tugas yang dibuat pengajar di UI Classroom, meskipun pengajar yang sama memiliki aplikasi tersebut. Jika hal ini membatasi kasus penggunaan Anda secara signifikan, sampaikan masukan di issue tracker publik.

Persyaratan lisensi

Pengguna hanya dapat membuat, memperbarui, dan menghapus rubrik dengan Classroom API jika kondisi berikut terpenuhi:

Lihat kelayakan pengguna untuk mempelajari lebih lanjut cara kemampuan API ditampilkan kepada pengguna dan prasyarat Classroom API untuk memahami, dan meminta, akun demo untuk pengembangan.

Sebelumnya
Periode Penilaian