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

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

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

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

  • มีรูปแบบการให้คะแนนเพียงรายการเดียว (สูงสุด) ที่เชื่อมโยงกับ CourseWork และรูปแบบการให้คะแนนนั้นใช้กับ CourseWork รายการนั้นเท่านั้น (ไม่สามารถแชร์กับแหล่งข้อมูล CourseWork รายการอื่นๆ ได้)
  • รูปแบบการให้คะแนนประกอบด้วยเกณฑ์ ซึ่งประกอบด้วยระดับ เกณฑ์การให้คะแนนต้องมีเกณฑ์อย่างน้อย 1 รายการเสมอ และเกณฑ์ต้องมีระดับอย่างน้อย 1 ระดับเสมอ
  • ระดับอาจมีคะแนน (มีคะแนน) หรือไม่มีคะแนนก็ได้ ระดับต้องให้คะแนนทั้งหมดหรือไม่ให้คะแนนเลยในตารางการให้คะแนน
    • หากมีการให้คะแนนระดับ ระดับทั้งหมดในเกณฑ์ต้องมีชุดค่าคะแนนที่ไม่ซ้ำกัน โดยคะแนนอาจเป็นจำนวนเต็ม (เช่น 10) หรือค่าทศนิยม (เช่น 9.99) ซึ่งรวมถึง 0 ระบบไม่ยอมรับค่า Null นอกจากนี้ รูบริกต้องมีเกณฑ์เดียวที่มีระดับเดียวซึ่งให้คะแนน 0
    • หากไม่มีการให้คะแนนระดับ คุณควรละเว้นช่องคะแนน และระบบจะไม่ยอมรับค่า Null
  • ลำดับของเกณฑ์และระดับมีความหมายและแสดงถึงลำดับที่แสดงใน UI ของ Classroom
    • โดยเฉพาะอย่างยิ่ง ระดับที่มีคะแนนต้องจัดเรียงตามคะแนนโดยเรียงจากน้อยไปมากหรือมากไปน้อยเสมอ
  • เกณฑ์การให้คะแนนแต่ละรายการมีเกณฑ์ได้สูงสุด 50 รายการและระดับประสิทธิภาพสูงสุด 10 ระดับ

ออบเจ็กต์ StudentSubmission รองรับช่องต่อไปนี้ซึ่งเกี่ยวข้องกับตำรา

  • นอกเหนือจากพร็อพเพอร์ตี้ draftGrade และ assignedGrade ที่มีอยู่แล้ว งานของนักเรียนที่ได้รับการให้คะแนนด้วยรูบริกจะมีพร็อพเพอร์ตี้ draftRubricGrades และ assignedRubricGrades ด้วย คะแนนเหล่านี้แสดงคะแนนตามเกณฑ์ (ระดับที่เลือกและคะแนนเต็ม) ที่นักเรียนได้รับระหว่างการให้คะแนนจากเกณฑ์ในสถานะ "ฉบับร่าง" และ "มอบหมายแล้ว" ตามลำดับ
  • ขณะนี้พร็อพเพอร์ตี้เหล่านี้เป็นแบบอ่านอย่างเดียว ซึ่งหมายความว่าคุณไม่สามารถใช้ API เพื่อให้คะแนนงานที่ส่ง แต่สามารถอ่านงานที่ส่งซึ่งให้คะแนนแล้วใน UI ของ Classroom

ลักษณะการทํางานของเกณฑ์การให้คะแนน

API มีจุดประสงค์เพื่อมิเรอร์ UI ของ Classroom ทุกครั้งที่เป็นไปได้เพื่อความสอดคล้องกัน แต่การดำเนินการนี้อาจทําให้นักพัฒนาแอปสับสนได้ ดังนี้

  • รูปแบบการให้คะแนนมีไว้เพื่อแนะนำการให้คะแนนโดยไม่จำกัดครู ด้วยเหตุนี้ ครูจึงสามารถดำเนินการต่อไปนี้เมื่อให้คะแนนงานที่ส่งด้วยรูปแบบการให้คะแนน
    • ไม่สนใจเกณฑ์การให้คะแนนเลยเมื่อตัดเกรด
    • ลบล้างคะแนนของเกณฑ์ โดยไม่คำนึงถึงคะแนนที่มีอยู่ในระดับของเกณฑ์
    • เลือกระดับสำหรับเกณฑ์เพียงบางส่วน
    • กำหนดคะแนนสำหรับเกณฑ์โดยไม่เลือกระดับที่สอดคล้องกัน
    • ลบล้างคะแนนรวมของงาน โดยไม่คำนึงถึงคะแนนที่มาจากเกณฑ์

นอกจากนี้ API ยังไม่รองรับลักษณะการทำงานที่ UI ของ Classroom ยังไม่มี ตัวอย่างเช่น API ไม่ได้บังคับให้ใช้เกณฑ์การให้คะแนนกับงานหรือลบล้างความสามารถของครูในการแก้ไขเกณฑ์การให้คะแนนและงานที่ส่งได้ในปัจจุบัน

ข้อจำกัดระหว่างการให้คะแนน

ในทำนองเดียวกัน การแก้ไขเกณฑ์การให้คะแนนก็มีข้อจำกัดเพิ่มเติมเมื่อคุณครูเริ่มให้คะแนนด้วยเกณฑ์นั้นแล้ว หลังจากการอัปเกรดเริ่มต้นแล้ว คุณจะทำการแก้ไขได้เฉพาะรายการต่อไปนี้เท่านั้น

  • อนุญาตให้แก้ไขข้อความสำหรับชื่อและคำอธิบายของเกณฑ์และระดับ
  • ลำดับระดับจะเปลี่ยนแปลงได้ภายในเกณฑ์

ขอบเขตเพิ่มเติม

คุณส่งออกเกณฑ์การให้คะแนนไปยัง Google สเปรดชีตด้วยตนเองเพื่อให้ครูนําไปใช้ซ้ำได้

หากคุณสร้างหรืออัปเดตรูปแบบการให้คะแนนจากสเปรดชีตเหล่านี้ (ดูตัวอย่างในคู่มือ) แอปพลิเคชันของคุณจะต้องขอขอบเขต https://www.googleapis.com/auth/spreadsheets.readonly หรือ https://www.googleapis.com/auth/spreadsheets โปรดทราบว่าspreadsheetsขอบเขตดังกล่าวถือว่ามีความละเอียดอ่อนและอาจกำหนดให้ต้องยืนยันแอปพลิเคชัน

งานหลักสูตรของบุคคลที่สาม

เฉพาะโปรเจ็กต์ Google Cloud ที่สร้างรายการหลักเท่านั้นที่สร้างเกณฑ์ได้ CourseWork นี่เป็นรูปแบบการออกแบบที่กว้างขึ้นใน Classroom API ซึ่งป้องกันไม่ให้แอปพลิเคชันต่างๆ ส่งผลกระทบต่อทรัพยากรที่ไม่ใช่ของตนเอง

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

ข้อกำหนดใบอนุญาต

ผู้ใช้จะสร้าง อัปเดต และลบรูปแบบการให้คะแนนด้วย Classroom API ได้ก็ต่อเมื่อมีคุณสมบัติตรงตามเงื่อนไขต่อไปนี้

ดูการมีสิทธิ์ของผู้ใช้เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีแสดงความสามารถของ API ต่อผู้ใช้และข้อกําหนดเบื้องต้นของ Classroom API เพื่อทําความคุ้นเคยและขอบัญชีเดโมสําหรับการพัฒนา

ก่อนหน้า
ระยะเวลาการให้คะแนน