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.

Tugas dan kiriman

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 pengiriman ditampilkan di aplikasi Classroom, assignedGrade akan otomatis disetel di StudentSubmission, dengan nilai yang sama dengan 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. Baca cara membuat dan mengelola nilai untuk mengetahui contoh kode terkait membaca, menetapkan, dan mengembalikan nilai.

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

Tugas yang terlambat, dimaafkan, dan tidak ada

Saat item CourseWork ditetapkan, placeholder StudentSubmissions akan 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 yang 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.

Pengiriman yang tidak ada dapat ditandai sebagai selesai atau dimaafkan 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.

Catatan: Status StudentSubmissions yang lengkap, tidak ada, dan dimaafkan tidak dapat diidentifikasi secara jelas di API. Jika perilaku ini akan memengaruhi aplikasi Anda, berikan masukan di masalah ini yang menjelaskan dampaknya terhadap kasus penggunaan Anda.

Lihat artikel bantuan memberi nilai dan menampilkan tugas untuk mempelajari lebih lanjut cara pengiriman tugas 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 mengikuti 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 benar-benar ada, Classroom 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 harus melakukan hal yang sama.

Periode penilaian

Pengajar dapat mengelompokkan tugas CourseWork di kursus ke dalam rentang tanggal 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 menyertakan StudentSubmissions yang jatuh tempo pada 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 di atas ditetapkan pada mata pelajaran yang menggunakan kategori penilaian tertimbang, pada akhirnya akan ada tiga kumpulan nilai keseluruhan untuk siswa:

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

Pratinjau Developer: Dukungan API untuk periode penilaian tersedia sebagai bagian dari Program Pratinjau Developer Google Workspace, yang memberikan akses awal ke fitur tertentu.

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.

Pratinjau Developer: Dukungan API untuk rubrika tersedia sebagai bagian dari Program Pratinjau Developer Google Workspace, yang memberikan akses awal ke fitur tertentu.

Rubrik memperluas resource StudentSubmissions dengan kolom tambahan:

• rubricId mengidentifikasi rubrik yang sesuai dengan CourseWork kiriman.
• draftRubricGrades merepresentasikan kriteria dan skor placeholder yang telah disusun 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.