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 terdiri dari kriteria, yang terdiri dari tingkat. Rubrik harus selalu memiliki minimal satu kriteria, dan kriteria harus selalu memiliki minimal satu level.
  • Level dapat dinilai (memiliki poin) atau tidak dinilai (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 floating point (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 level tidak diberi skor, kolom poin harus dihilangkan; nilai null tidak diterima.
  • Urutan kriteria dan level memiliki arti dan mencerminkan urutan yang ditampilkan di UI Classroom.
    • Level skor secara khusus harus selalu diurutkan berdasarkan poin dalam urutan meningkat atau menurun.
  • Dapat ada 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. 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 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 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:
    • Mengabaikan rubrik sepenuhnya 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 tidak mendukung perilaku yang belum dimiliki UI Classroom. Misalnya, API tidak mengaktifkan penerapan penggunaan rubrik pada tugas atau mengganti kemampuan pengajar untuk mengedit rubrik dan kiriman seperti yang dapat mereka lakukan 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 pengajar.

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.

Mata pelajaran 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 milik mereka.

Hal ini juga berlaku untuk materi 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 secara signifikan membatasi kasus penggunaan Anda, bagikan 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