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

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

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

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

• CourseWork`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 ได้ก็ต่อเมื่อเป็นไปตามเงื่อนไขต่อไปนี้

• ผู้ใช้ที่ส่งคำขอมีใบอนุญาต Google Workspace for Education Plus ที่มอบหมายให้
• เจ้าของหลักสูตรของหลักสูตรที่เกี่ยวข้องมีใบอนุญาต Google Workspace for Education Plusที่มอบหมายให้

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