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 dinilai, CourseWork memiliki nilai maxPoints yang mewakili jumlah total poin tugas. Jika maxPoints nol atau tidak ditentukan, tugas tidak akan dinilai.

Untuk tugas yang dinilai, pengajar menetapkan nilai draftGrade di StudentSubmission sebelum mengembalikannya kepada siswa. Saat kiriman ditampilkan di aplikasi Classroom, assignedGrade akan ditetapkan secara otomatis di StudentSubmission, dengan nilai yang sama seperti draftGrade saat ini. Developer dapat menetapkan kedua kolom ini, dan harus mengemulasi perilaku aplikasi Classroom. Misalnya, assignedGrade tidak dapat ditetapkan tanpa draftGrade. Kedua kolom direpresentasikan dengan desimal, dan jika tidak ditetapkan, menyiratkan bahwa guru belum menetapkan nilai yang sesuai. Lihat membuat dan mengelola nilai untuk mengetahui contoh kode membaca, menetapkan, dan menampilkan nilai.

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

Tugas Kursus yang terlambat, dimaafkan, dan tidak ada

Saat item CourseWork ditetapkan, placeholder StudentSubmissions dibuat untuk setiap siswa, meskipun siswa belum berinteraksi dengan tugas yang sesuai. Pengajar dapat menetapkan dueDate di 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 dikirimkan sebelum dueDate akan dianotasi di buku nilai Classroom sebagai tidak ada. Pengajar juga dapat menandai kiriman sebagai tidak ada secara manual di aplikasi Classroom. Tugas yang tidak ada otomatis diberi draftGrade, yang dapat disesuaikan oleh pengajar, tetapi secara default adalah 0.

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

Lihat artikel bantuan memberi nilai dan menampilkan tugas untuk mempelajari lebih lanjut cara pengiriman dapat ditangani 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. Praktik terbaiknya adalah mematuhi hal ini di aplikasi Anda sendiri jika memungkinkan. Misalnya, jika siswa tidak dapat melihat nilai keseluruhan mereka di Classroom, jangan tampilkan nilai tersebut kepada mereka 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 yang sebenarnya ada, Classroom akan menyesuaikan bobot menjadi ~22% untuk pekerjaan rumah dan ~78% untuk kuis saat menghitung nilai keseluruhan. Jika ingin mencerminkan nilai keseluruhan Classroom di aplikasi, 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 bucket yang berbeda untuk penghitungan nilai keseluruhan.

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

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

  • Nilai keseluruhan untuk semua tugas dalam kursus.
  • 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.

Periode penilaian memperluas CourseWork dengan gradingPeriodId yang mengidentifikasi periode penilaian yang termasuk dalam tugas.

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 menggunakan rubrik di Classroom.

Rubrik memperluas resource StudentSubmissions 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 rubrics API 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 numerik menjadi nilai huruf. Setelan ini dan data yang sesuai tidak tersedia di API.