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

หากไม่คุ้นเคยกับเกณฑ์การให้คะแนนของ Classroom โปรดดูบทความเหล่านี้ในศูนย์ช่วยเหลือเพื่อเรียนรู้เกี่ยวกับโครงสร้างทั่วไปของเกณฑ์การให้คะแนนและวิธีการให้คะแนนด้วยเกณฑ์การให้คะแนนใน UI ของ Classroom

โครงสร้างเกณฑ์การให้คะแนน

แนวคิดสำคัญบางประการที่ควรไฮไลต์เมื่อใช้ API ในการโต้ตอบกับเกณฑ์การให้คะแนนมีดังนี้

• มีเกณฑ์การให้คะแนน 1 รายการที่เชื่อมโยงกับ CourseWork อยู่ (มากที่สุด) และเกณฑ์การให้คะแนนดังกล่าวซ้ำกับ CourseWork นั้น (แชร์ไม่ได้ในทรัพยากร CourseWork)
• เกณฑ์การให้คะแนนประกอบด้วยเกณฑ์ซึ่งประกอบด้วยระดับต่างๆ โดยเกณฑ์ต้องมีอย่างน้อย 1 เกณฑ์เสมอ และเกณฑ์จะต้องมีอย่างน้อย 1 ระดับเสมอ
• โดยจะให้คะแนนได้ (ได้คะแนน) หรือไม่ได้คะแนน (ไม่มีคะแนน) แต่ละระดับจะต้องได้คะแนนเต็มหรือไม่มีคะแนนเต็มในเกณฑ์การให้คะแนน
  • หากมีการให้คะแนนระดับ ทุกระดับในเกณฑ์ต้องมีชุดค่าคะแนนที่ไม่ซ้ำกัน คะแนนอาจเป็นจำนวนเต็ม (เช่น 10) หรือค่าทศนิยม (เช่น 9.99) ซึ่งอาจรวม 0 ระบบไม่ยอมรับค่า Null นอกจากนี้ เกณฑ์การให้คะแนนต้องไม่มีเกณฑ์ข้อเดียวที่มีระดับเดียว เท่ากับ 0 คะแนน
  • หากระดับไม่มีคะแนน ควรเว้นช่องคะแนนไว้ และไม่ยอมรับค่าว่าง
• ลำดับของเกณฑ์และระดับนั้นมีความหมายและสอดคล้องกับลำดับที่แสดงใน 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 ถือว่ามีความละเอียดอ่อนและอาจต้องยืนยันแอปพลิเคชันของคุณ