หากไม่คุ้นเคยกับเกณฑ์การให้คะแนนของ Classroom โปรดอ่านบทความเหล่านี้ในศูนย์ช่วยเหลือเพื่อดูข้อมูลเกี่ยวกับโครงสร้างทั่วไปของเกณฑ์การให้คะแนนและวิธีที่การให้คะแนนด้วยเกณฑ์การให้คะแนนใน UI ของ Classroom
โครงสร้างของเกณฑ์การให้คะแนน
แนวคิดสําคัญบางประการที่ควรไฮไลต์เมื่อใช้ API เพื่อโต้ตอบกับรูปแบบการให้คะแนนมีดังนี้
- มีเกณฑ์การให้คะแนน 1 รายการ (โดยส่วนใหญ่) ที่เชื่อมโยงกับ
CourseWork
และเกณฑ์การให้คะแนนดังกล่าวจะใช้เฉพาะกับCourseWork
ดังกล่าว (แชร์ในทรัพยากรCourseWork
รายการไม่ได้) - รูปแบบการให้คะแนนประกอบด้วยเกณฑ์ ซึ่งประกอบด้วยระดับ เกณฑ์การให้คะแนนต้องมีเกณฑ์อย่างน้อย 1 รายการเสมอ และเกณฑ์ต้องมีระดับอย่างน้อย 1 ระดับเสมอ
- ระดับอาจมีคะแนน (มีคะแนน) หรือไม่มีคะแนนก็ได้ ระดับต้องให้คะแนนทั้งหมดหรือไม่ให้คะแนนเลยในตารางการให้คะแนน
- หากมีการให้คะแนนระดับ ระดับทั้งหมดในเกณฑ์ต้องมีชุดค่าคะแนนที่ไม่ซ้ำกัน โดยคะแนนอาจเป็นจำนวนเต็ม (เช่น 10) หรือค่าทศนิยม (เช่น 9.99) ซึ่งรวมถึง 0 ไม่ยอมรับค่า Null นอกจากนี้ รูบริกต้องมีเกณฑ์เดียวที่มีระดับเดียวซึ่งให้คะแนน 0
- หากระดับไม่มีคะแนน ก็ไม่ควรระบุช่องคะแนน และระบบจะไม่ยอมรับค่า Null
- ลำดับของเกณฑ์และระดับนั้นมีความหมายและแสดงถึงลำดับที่แสดงใน UI ของ Classroom
- โดยเฉพาะอย่างยิ่ง ระดับที่มีคะแนนต้องจัดเรียงตามคะแนนโดยเรียงจากน้อยไปมากหรือมากไปน้อยเสมอ
- เกณฑ์การให้คะแนนจะมีเกณฑ์ได้สูงสุด 50 รายการต่อเกณฑ์การให้คะแนนและระดับประสิทธิภาพสูงสุด 10 รายการต่อเกณฑ์
ช่องการส่งงานที่เกี่ยวข้องของนักเรียน
นอกจากนี้ ออบเจ็กต์การส่งงานของนักเรียนยังมีการเปลี่ยนแปลงด้วย ดังนี้
- นอกเหนือจากพร็อพเพอร์ตี้
draftGrade
และassignedGrade
ที่มีอยู่แล้ว งานที่นักเรียนให้คะแนนด้วยเกณฑ์การให้คะแนนยังมีพร็อพเพอร์ตี้draftRubricGrades
และassignedRubricGrades
ซึ่งจะแสดงคะแนนแบบตามเกณฑ์ (ระดับที่เลือกและค่าคะแนน) ที่นักเรียนได้รับระหว่างการให้คะแนนจากเกณฑ์การให้คะแนน ในสถานะฉบับร่างและที่มอบหมายตามลำดับ - ขณะนี้พร็อพเพอร์ตี้เหล่านี้เป็นแบบอ่านอย่างเดียว ซึ่งหมายความว่าคุณไม่สามารถใช้ API เพื่อให้คะแนนงานที่ส่ง แต่สามารถอ่านงานที่ส่งซึ่งให้คะแนนแล้วใน UI ของ Classroom
- งานที่นักเรียนส่งซึ่งมีเกณฑ์การให้คะแนนที่เกี่ยวข้องจะมีช่อง
rubricId
ช่องนี้แสดงเกณฑ์การให้คะแนนล่าสุดที่เชื่อมโยงกับCourseWork
และค่านี้อาจเปลี่ยนแปลงหากครูลบและสร้างเกณฑ์การให้คะแนนใหม่
ลักษณะการทํางานของเกณฑ์การให้คะแนน
API มีจุดประสงค์เพื่อมิเรอร์ UI ของ Classroom ทุกครั้งที่เป็นไปได้เพื่อให้สอดคล้องกัน แต่การดำเนินการนี้อาจทําให้นักพัฒนาแอปสับสนได้ ดังนี้
- รูปแบบการให้คะแนนมีไว้เพื่อแนะนำการให้คะแนนโดยไม่จำกัดครู ดังนั้น ครูจะทำสิ่งต่อไปนี้ได้เมื่อให้คะแนนงานที่ส่งด้วยเกณฑ์การให้คะแนน
- ไม่ต้องสนใจเกณฑ์การให้คะแนนทั้งหมดเมื่อให้คะแนน
- ลบล้างคะแนนของเกณฑ์ โดยไม่คำนึงถึงคะแนนที่มีอยู่ในระดับของเกณฑ์
- เลือกระดับสำหรับเกณฑ์เพียงบางส่วน
- กำหนดคะแนนสำหรับเกณฑ์โดยไม่เลือกระดับที่สอดคล้องกัน
- ลบล้างคะแนนรวมของงานโดยไม่คํานึงถึงคะแนนที่จะมาจากเกณฑ์การให้คะแนน
นอกจากนี้ API ไม่ได้เปิดตัวความสามารถใหม่ๆ ของผลิตภัณฑ์ กล่าวคือ API ไม่รองรับลักษณะการทำงานที่ UI ของ Classroom ยังไม่มี ตัวอย่างเช่น API ไม่ได้บังคับให้ใช้เกณฑ์การให้คะแนนกับงานหรือลบล้างความสามารถของครูในการแก้ไขเกณฑ์การให้คะแนนและงานที่ส่งได้ในปัจจุบัน
ข้อจำกัดระหว่างการให้คะแนน
ในทำนองเดียวกัน การแก้ไขเกณฑ์การให้คะแนนก็มีข้อจำกัดเพิ่มเติมเมื่อคุณครูเริ่มให้คะแนนด้วยเกณฑ์นั้นแล้ว โดยหลังจากให้คะแนนว่าเริ่มต้นแล้ว จะมีเพียงการแก้ไขต่อไปนี้เท่านั้น
- อนุญาตให้แก้ไขข้อความสำหรับชื่อและคำอธิบายของเกณฑ์ ระดับได้
- ลำดับระดับจะเปลี่ยนแปลงได้ภายในเกณฑ์
ขอบเขตเพิ่มเติม
คุณส่งออกเกณฑ์การให้คะแนนไปยัง Google สเปรดชีตด้วยตนเองเพื่อให้ครูนําไปใช้ซ้ำได้
หากคุณสร้างหรืออัปเดตรูปแบบการให้คะแนนจากสเปรดชีตเหล่านี้ (ดูตัวอย่างในคู่มือ) แอปพลิเคชันของคุณจะต้องขอขอบเขต https://www.googleapis.com/auth/spreadsheets.readonly
หรือ https://www.googleapis.com/auth/spreadsheets
โปรดทราบว่าspreadsheets
ขอบเขตดังกล่าวถือว่ามีความละเอียดอ่อนและอาจกำหนดให้ต้องยืนยันแอปพลิเคชัน