คะแนน

เอกสารนี้จะแนะนำแนวคิดเกี่ยวกับการให้คะแนนที่เกี่ยวข้องกับ Classroom API

อ่านบทความให้คะแนนและติดตามงานเพื่อดูข้อมูลเกี่ยวกับเส้นทางการให้คะแนนของครูในแอป Google Classroom

งานในหลักสูตรและงานที่ส่ง

ใน Google Classroom นักเรียนส่งStudentSubmissions สำหรับงาน CourseWork ใน Course CourseWork สามารถให้คะแนนหรือยกเลิกการให้คะแนนได้ หากมีการให้คะแนน CourseWork จะมีค่า maxPoints ซึ่งแสดงถึงคะแนนเต็มของงาน หาก maxPoints เป็น 0 หรือไม่ได้ระบุไว้ งานจะไม่ได้รับคะแนน

สำหรับงานที่มีคะแนน ครูจะตั้งค่าคะแนน draftGrade ใน StudentSubmission ก่อนส่งคืนงานให้นักเรียน เมื่อส่งคืนงานที่ส่งในแอป Classroom ระบบจะตั้งค่า assignedGrade ใน StudentSubmission โดยอัตโนมัติ ด้วยค่าเดียวกับ draftGrade ปัจจุบัน นักพัฒนาแอปสามารถตั้งค่าทั้ง 2 ช่องนี้และต้องจำลองลักษณะการทำงานของแอป Classroom เช่น ไม่สามารถตั้งค่า assignedGrade ได้หากไม่มี draftGrade ทั้ง 2 ช่องจะแสดงด้วยทศนิยม และหากไม่ได้ตั้งค่าไว้ แสดงว่าครูยังไม่ได้ตั้งค่าคะแนนที่สอดคล้องกัน ดูตัวอย่างโค้ดการอ่าน การตั้งค่า และการคืนค่าคะแนนได้ที่หัวข้อสร้างและจัดการคะแนน

นักเรียนสามารถส่งงานCourseWorkงานเดียวกันได้หลายครั้ง ระบบจะติดตามสถานะการส่งงานและประวัติการให้คะแนนในStudentSubmission.submissionHistory

การบ้านและรายงานล่าช้า ไม่ได้รับข้อยกเว้น และไม่มี

เมื่อมอบหมายรายการ CourseWork ระบบจะสร้างตัวยึดตำแหน่ง StudentSubmissions ให้กับนักเรียนแต่ละคน แม้ว่านักเรียนจะยังไม่ได้โต้ตอบกับงานที่เกี่ยวข้องก็ตาม ครูจะตั้งค่า dueDate ใน CourseWork ได้ และ StudentSubmissions ที่เกี่ยวข้องจะมีช่อง late กำกับอยู่ (ตั้งค่าเป็น true) หากนักเรียนไม่ส่งงานก่อนวันที่ดังกล่าว นอกจากนี้ ครูยังปิดใช้การส่งงานล่าช้าได้ด้วยการตั้งค่าในแอป Classroom

นอกจากนี้ StudentSubmissions ที่ส่งก่อนวันที่ dueDate จะไม่มีคำอธิบายประกอบในสมุดพกของ Classroom ว่าขาดหายไป ครูยังทำเครื่องหมายงานที่ส่งว่า "ยังไม่ได้ส่ง" ด้วยตนเองในแอป Classroom ได้ด้วย โดยระบบจะกำหนดคะแนน draftGrade ให้กับงานที่ยังไม่ได้ส่งโดยอัตโนมัติ ซึ่งครูจะปรับแต่งได้ แต่คะแนนเริ่มต้นจะเป็น 0

ครูสามารถทําเครื่องหมายงานที่ยังไม่ได้ส่งว่าเสร็จสมบูรณ์หรือได้รับการยกเว้น ระบบจะนำช่อง draftGrade เริ่มต้นของStudentSubmissionsที่ทำเครื่องหมายว่าเสร็จสมบูรณ์ออกจนกว่าครูจะตั้งค่าใหม่ด้วยตนเอง ระบบจะนำ StudentSubmissions ที่มีเครื่องหมายยกเว้นออกจากการคำนวณคะแนนโดยรวม รวมถึงระยะเวลาการให้คะแนน

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

ระบบการให้คะแนนและการให้คะแนนโดยรวม

Classroom รองรับระบบการให้คะแนนหลายระบบสำหรับการคำนวณคะแนนโดยรวมของนักเรียนในหลักสูตร คุณสามารถคำนวณคะแนนโดยรวมได้โดยตรงจากคะแนนรวม ถ่วงน้ำหนักตามหมวดหมู่ หรือไม่ต้องคำนวณเลย

ดูบทความตั้งค่าการให้คะแนนเพื่อดูข้อมูลเกี่ยวกับระบบการให้คะแนนต่างๆ พร้อมตัวอย่าง

ประเด็นสำคัญมีดังนี้

• แหล่งข้อมูล Course มีออบเจ็กต์ gradebookSettings ที่มีรายละเอียดเกี่ยวกับการตั้งค่าคะแนนของหลักสูตร
  • calculationType จะระบุวิธีการคำนวณสำหรับหลักสูตร
  • displaySettings ระบุผู้ที่สามารถดูคะแนนโดยรวมในแอป Classroom แนวทางปฏิบัติแนะนำคือให้ปฏิบัติตามข้อกำหนดนี้ในแอปพลิเคชันของคุณเองเมื่อเป็นไปได้ เช่น หากนักเรียนไม่เห็นคะแนนโดยรวมของตนเองใน Classroom ก็อย่าแสดงคะแนนดังกล่าวให้นักเรียนเห็นในแอป
  • gradeCategories มีรายการหมวดหมู่การให้คะแนนที่กำหนดค่าไว้สำหรับหลักสูตร รวมถึงชื่อที่แสดง เปอร์เซ็นต์การถ่วงน้ำหนัก และคะแนนเริ่มต้นสำหรับงานที่เกี่ยวข้อง
• หากหลักสูตรใช้การตัดเกรดแบบถ่วงน้ำหนัก คุณอาจต้องทำให้น้ำหนักเป็นมาตรฐานในกรณีที่ไม่มีหมวดหมู่ เช่น หากน้ำหนักของหมวดหมู่คือ 20% สำหรับการบ้าน 10% สำหรับแบบฝึกหัดแก้ปัญหา และ 70% สำหรับแบบทดสอบ แต่ไม่มีแบบฝึกหัดแก้ปัญหาจริง ๆ Classroom จะปรับน้ำหนักเป็นประมาณ 22% สำหรับการบ้านและประมาณ 78% สำหรับแบบทดสอบเมื่อคำนวณคะแนนโดยรวม หากต้องการมิเรอร์คะแนนโดยรวมของ Classroom ในแอปพลิเคชัน คุณจะต้องดำเนินการในลักษณะเดียวกัน

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

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

เช่น ครูอาจสร้างระยะเวลาการให้คะแนนในภาคการศึกษา "ฤดูใบไม้ผลิ" และ "ฤดูใบไม้ร่วง" คะแนนโดยรวมสำหรับภาคการศึกษาฤดูใบไม้ผลิจะรวมเฉพาะ StudentSubmissions ที่ครบกำหนดส่งในช่วงวันที่ของฤดูใบไม้ผลิเท่านั้น

ระบบการให้คะแนนที่กำหนดไว้สำหรับหลักสูตรจะมีผลกับระยะเวลาการให้คะแนน ดังนั้น หากตั้งค่าระยะเวลาการให้คะแนนตัวอย่างฤดูใบไม้ผลิและฤดูใบไม้ร่วงที่กล่าวถึงข้างต้นในหลักสูตรที่ใช้หมวดหมู่การให้คะแนนแบบถ่วงน้ำหนัก นักเรียนจะได้รับคะแนนโดยรวม 3 ชุดดังนี้

• คะแนนโดยรวมสำหรับงานทั้งหมดในหลักสูตร
• คะแนนโดยรวมสำหรับงานทั้งหมดในช่วงวันที่ของฤดูใบไม้ผลิ
• คะแนนโดยรวมสำหรับงานทั้งหมดในช่วงวันที่ของฤดูใบไม้ร่วง

ทั้ง 3 กรณีนี้จะคำนวณเกรดโดยรวมด้วยหมวดหมู่แบบถ่วงน้ำหนัก

ดูข้อมูลภาพรวมของฟีเจอร์ได้ในประกาศเกี่ยวกับระยะเวลาการให้คะแนน

ระยะเวลาการให้คะแนนจะขยายไปอีก CourseWork ด้วย gradingPeriodId ซึ่งระบุระยะเวลาการให้คะแนนของงาน

ดูคำแนะนำเกี่ยวกับ API ระยะเวลาการให้คะแนนเพื่อดูวิธีอ่านและจัดการระยะเวลาการให้คะแนนด้วย API

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

ครูสามารถสร้างและเชื่อมโยง Rubrics กับ CourseWork งาน และใช้เกณฑ์การให้คะแนนเหล่านี้เป็นแนวทางเมื่อให้คะแนน StudentSubmissions ที่เกี่ยวข้อง

ดูบทความเกี่ยวกับรูปแบบการให้คะแนนเพื่อดูวิธีที่ครูใช้รูปแบบการให้คะแนนใน Classroom ได้

รูปแบบการให้คะแนนจะขยายทรัพยากร StudentSubmissions ด้วยช่องเพิ่มเติม ดังนี้

• rubricId จะระบุเกณฑ์การให้คะแนนที่สอดคล้องกับ CourseWork ของงานที่ส่ง
• draftRubricGrades แสดงถึงเกณฑ์และคะแนนตัวยึดตำแหน่งที่ผู้สอนร่างไว้ก่อนที่จะส่งงานคืนให้นักเรียน
• assignedRubricGrades แสดงถึงเกณฑ์และคะแนนที่นักเรียนได้รับหลังจากที่ครูส่งงานคืน

ดูวิธีจัดการเกณฑ์การให้คะแนนและอ่านคะแนนที่เกี่ยวข้องด้วย API ได้ในคู่มือ rubrics API

รูปแบบการให้คะแนน

Classroom รองรับรูปแบบการให้คะแนนที่ปรับแต่งได้ เช่น ทำให้ครูแปลคะแนนที่เป็นตัวเลขเป็นคะแนนตัวอักษรได้ การตั้งค่าเหล่านี้และข้อมูลที่เกี่ยวข้องไม่พร้อมใช้งานใน API