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

หากยังไม่คุ้นเคยกับรูบริกของ 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 ได้ก็ต่อเมื่อตรงตามเงื่อนไขต่อไปนี้

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

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