เอกสารนี้จะแนะนำแนวคิดการให้คะแนนที่เกี่ยวข้องกับ 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 ช่องจะแสดงด้วยทศนิยม และหากไม่ได้ตั้งค่าไว้ แสดงว่าครูยังไม่ได้ตั้งค่าคะแนนที่สอดคล้องกัน
ดูตัวอย่างโค้ดการอ่าน การตั้งค่า และการคืนค่าคะแนนได้ที่หัวข้อสร้างและจัดการคะแนน
นักเรียนสามารถส่งงานสำหรับ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