Nilai

Dokumen ini memperkenalkan konsep penilaian yang relevan dengan Classroom API.

Lihat artikel memberi nilai dan melacak tugas untuk mempelajari perjalanan pemberian nilai pengajar di aplikasi Google Classroom.

CourseWork dan StudentSubmissions

Di Google Classroom, siswa menyerahkan StudentSubmissions untuk tugas CourseWork di Course mereka. CourseWork dapat dinilai atau tidak dinilai. Jika diberi nilai, CourseWork memiliki nilai maxPoints yang mewakili jumlah total poin yang diperoleh tugas. Jika maxPoints adalah nol atau tidak ditentukan, tugas tidak dinilai.

Untuk tugas yang dinilai, pengajar menetapkan draftGrade nilai pada StudentSubmission sebelum mengembalikannya kepada siswa. Saat tugas dikembalikan di aplikasi Classroom, assignedGrade akan otomatis ditetapkan di StudentSubmission, dengan nilai yang sama seperti draftGrade saat ini. Developer dapat menetapkan kedua kolom ini, dan harus meniru perilaku aplikasi Classroom. Misalnya, assignedGrade tidak dapat ditetapkan tanpa draftGrade. Kedua kolom ditampilkan dengan angka desimal, dan jika tidak disetel, berarti pengajar belum menetapkan nilai yang sesuai. Lihat membuat dan mengelola nilai untuk contoh kode membaca, menyetel, dan mengembalikan nilai.

Siswa dapat mengirimkan beberapa kiriman tugas yang sama CourseWork, dan status kiriman tugas serta histori nilai dilacak di StudentSubmission.submissionHistory.

Tugas Kursus yang terlambat, dibebaskan, dan tidak diserahkan

Saat item CourseWork ditetapkan, placeholder StudentSubmissions dibuat untuk setiap siswa, meskipun siswa belum berinteraksi dengan tugas yang sesuai. Pengajar dapat menetapkan dueDate pada CourseWork, dan StudentSubmissions terkait ditandai dengan kolom late (ditetapkan ke true) jika siswa tidak menyerahkan tugas sebelum tanggal tersebut. Pengajar juga dapat menonaktifkan pengiriman terlambat dengan setelan di aplikasi Classroom.

Selain itu, StudentSubmissions yang tidak dikumpulkan sebelum dueDate akan diberi anotasi di buku nilai Classroom sebagai belum diserahkan. Pengajar juga dapat menandai pengiriman sebagai tidak diserahkan secara manual di aplikasi Classroom. Tugas yang tidak diserahkan secara otomatis diberi draftGrade, yang dapat disesuaikan oleh pengajar, tetapi secara default adalah 0.

Kiriman tugas yang tidak diserahkan dapat ditandai sebagai selesai atau dibebaskan oleh pengajar. StudentSubmissions yang ditandai sebagai selesai akan menghapus kolom draftGrade defaultnya hingga pengajar menetapkan kolom baru secara manual. StudentSubmissions yang ditandai sebagai dibebaskan akan dihapus dari penghitungan skor keseluruhan, termasuk periode penilaian.

Lihat artikel bantuan memberi nilai dan mengembalikan tugas untuk mempelajari lebih lanjut cara penanganan kiriman oleh pengajar.

Nilai keseluruhan dan sistem penilaian

Classroom mendukung beberapa sistem penilaian untuk menghitung nilai keseluruhan siswa dalam kursus. Nilai keseluruhan dapat dihitung langsung dari poin total, bobot nilai berdasarkan kategori, atau tidak dihitung sama sekali.

Lihat artikel menyiapkan penilaian untuk mempelajari berbagai sistem penilaian dengan contoh.

Beberapa poin penting:

• Resource Course memiliki objek gradebookSettings dengan detail tentang setelan nilai kursus.
  • calculationType menentukan metode penghitungan untuk kursus.
  • displaySettings menentukan siapa yang dapat melihat nilai keseluruhan di aplikasi Classroom. Sebaiknya patuhi hal ini di aplikasi Anda sendiri jika memungkinkan. Misalnya, jika siswa tidak dapat melihat nilai keseluruhan mereka di Classroom, jangan tampilkan nilai tersebut di aplikasi Anda.
  • gradeCategories berisi daftar kategori penilaian yang dikonfigurasi untuk kursus, termasuk nama tampilan, persentase bobot, dan poin default untuk tugas yang sesuai.
• Jika kursus menggunakan penilaian berbobot, Anda mungkin perlu menormalisasi bobot dalam skenario saat kategori tidak ada. Misalnya, jika bobot kategori adalah 20% untuk pekerjaan rumah, 10% untuk soal latihan, dan 70% untuk kuis, tetapi tidak ada soal latihan, Classroom akan menyesuaikan bobot menjadi ~22% untuk pekerjaan rumah dan ~78% untuk kuis saat menghitung nilai keseluruhan. Jika Anda ingin mencerminkan nilai keseluruhan Classroom di aplikasi Anda, Anda harus melakukan hal yang sama.

Periode penilaian

Pengajar dapat mengelompokkan CourseWork tugas dalam kursus ke dalam rentang tanggal yang berbeda yang disebut periode penilaian. Periode penilaian dapat digunakan untuk memfilter tugas di tampilan buku nilai dan membuat kelompok yang berbeda untuk penghitungan nilai keseluruhan.

Misalnya, seorang pengajar dapat membuat periode penilaian semester "musim semi" dan "musim gugur". Skor nilai keseluruhan untuk periode musim semi hanya akan mencakup StudentSubmissions yang jatuh tempo dalam rentang tanggal musim semi.

Sistem penilaian yang ditetapkan untuk kursus berlaku untuk periode penilaian. Jadi, jika periode penilaian contoh musim semi dan musim gugur yang disebutkan di atas ditetapkan pada kursus yang menggunakan kategori penilaian berbobot, pada akhirnya akan ada tiga set nilai keseluruhan untuk siswa:

• Nilai keseluruhan untuk semua tugas dalam mata pelajaran.
• Nilai keseluruhan untuk semua tugas dalam rentang tanggal musim semi.
• Nilai keseluruhan untuk semua tugas dalam rentang tanggal musim gugur.

Ketiganya akan menghitung nilai keseluruhan dengan kategori berbobot.

Lihat pengumuman periode penilaian untuk mendapatkan ringkasan fitur ini.

Periode penilaian memperluas CourseWork dengan gradingPeriodId yang mengidentifikasi periode penilaian tempat tugas berada.

Lihat panduan API periode penilaian untuk mempelajari cara membaca dan mengelola periode penilaian dengan API.

Rubrik

Pengajar dapat membuat dan mengaitkan Rubrics dengan tugas CourseWork, dan menggunakan rubrik ini sebagai panduan saat menilai StudentSubmissions yang sesuai.

Lihat artikel rubrik untuk mempelajari cara pengajar dapat menggunakan rubrik di Classroom.

Rubrik memperluas StudentSubmissions resource dengan kolom tambahan:

• rubricId mengidentifikasi rubrik yang sesuai dengan CourseWork kiriman.
• draftRubricGrades mewakili kriteria dan skor placeholder yang telah dibuat drafnya oleh pengajar sebelum mengembalikan kiriman kepada siswa.
• assignedRubricGrades mewakili kriteria dan skor yang diterima siswa setelah pengajar mengembalikan kiriman.

Lihat panduan API rubrik untuk mengetahui cara mengelola rubrik dan membaca nilai terkait dengan API.

Skala penilaian

Classroom mendukung skala penilaian yang dapat disesuaikan, misalnya, memungkinkan pengajar menerjemahkan nilai angka menjadi nilai huruf. Setelan ini dan data yang sesuai tidak tersedia di API.