คะแนน

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

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

CourseWork และ StudentSubmissions

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

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

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

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

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

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

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

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

เกรดโดยรวมและระบบการตัดเกรด

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

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

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

• Course resource มีออบเจ็กต์ 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 ได้ที่คู่มือ API ของรูบริก

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

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