โครงสร้างเกณฑ์การให้คะแนนและข้อจํากัดที่ทราบ

หากไม่คุ้นเคยกับเกณฑ์การให้คะแนนของ 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ขอบเขตดังกล่าวถือว่ามีความละเอียดอ่อนและอาจกำหนดให้ต้องยืนยันแอปพลิเคชัน