หน้านี้กล่าวถึงรายละเอียดการติดตั้งใช้งานสำหรับการสร้างไฟล์แนบและ ในงานที่นักเรียนส่ง โปรดทราบว่าคุณอาจต้องระบุ พารามิเตอร์ที่เกี่ยวข้องกับไฟล์แนบเมื่อส่งคำขอเหล่านี้
สร้างไฟล์แนบ
สร้างไฟล์แนบโดยส่งคำขอ CREATE
ไปยัง
อุปกรณ์ปลายทาง courses.*.addOnAttachments.create
คำขอของคุณต้องมี
อินสแตนซ์ของ AddOnAttachment
ในเนื้อหาคำขอ
ต้องกรอกข้อมูลในช่องต่อไปนี้เมื่อสร้างไฟล์แนบ
title
: ชื่อสตริงของไฟล์แนบteacherViewUri
: URI สำหรับมุมมองครูของไฟล์แนบstudentViewUri
: URI สำหรับมุมมองของนักเรียนของไฟล์แนบstudentWorkReviewUri
: URI สำหรับครูเพื่อดูงานของนักเรียน ไฟล์แนบ ต้องกรอกข้อมูลในช่องนี้สำหรับไฟล์แนบประเภทกิจกรรมเท่านั้น
คุณควรใส่ช่องที่ไม่บังคับต่อไปนี้
dueDate
และdueTime
หากระบุว่าต้องส่งไฟล์แนบเมื่อใดmaxPoints
: คะแนนสูงสุดสำหรับไฟล์แนบ ต้องเป็นค่าที่ไม่ใช่ 0 หากต้องการรองรับการส่งคืนเกรด ใช้กับไฟล์แนบประเภทกิจกรรม เท่านั้น
ดูรายละเอียดเพิ่มเติมเกี่ยวกับช่องเหล่านี้ได้ในข้อมูลอ้างอิงแหล่งข้อมูลของ AddOnAttachment
รายละเอียดการส่งงานของนักเรียน
ขั้นตอนการทำงานการส่งทั่วไปมีดังนี้
- นักเรียนเปิด
studentViewUri
เพื่อทำกิจกรรมให้เสร็จ - ส่วนเสริมเรียกข้อมูล
submissionId
จากเมธอดgetAddOnContext
โดยใช้ข้อมูลเข้าสู่ระบบของนักเรียน submissionId
และattachmentId
จะจัดเก็บโดยส่วนเสริม เป็นตัวระบุที่ไม่ซ้ำกันสำหรับงานของนักเรียน ในกรณีที่ เมื่อครูคัดลอกงานใน Classroom คุณจะสามารถใช้ คีย์ผสมของพารามิเตอร์ทั้งสองนี้เพื่อแสดงไฟล์แนบใหม่ใน คัดลอกงานแล้ว ดูรายละเอียดเพิ่มเติมได้ที่หน้าของเราเกี่ยวกับเนื้อหาที่คัดลอกมา- ครูที่สนใจตรวจงานของนักเรียนเปิดตัว
studentWorkReviewUri
คำขอประกอบด้วยพารามิเตอร์การค้นหาต่อไปนี้courseId
,itemId
,itemType
,attachmentId
และsubmissionId
- นักพัฒนาส่วนเสริมจะใช้รหัสทั้ง 4 รหัสนี้เพื่อเรียกดูงานของนักเรียน ใช้
ปลายทาง
courses.courseWork.addOnAttachments.studentSubmissions
เพื่อ เรียกหรือแก้ไขข้อมูลเกี่ยวกับงานที่นักเรียนส่ง
ตรวจหาสถานะการส่ง
ส่งคำขอGET
ไปยัง
courses.courseWork.addOnAttachments.studentSubmissions
ปลายทางเพื่อรับ
รายละเอียดเกี่ยวกับsubmissionId
บางรายการ คุณจะได้รับ
AddOnAttachmentStudentSubmission
ซึ่งมีคะแนนของงานที่ส่ง
(pointsEarned
) และสถานะปัจจุบัน (postSubmissionState
) สถานะการส่ง
สามารถใช้ค่าใดค่าหนึ่งต่อไปนี้
NEW
หากนักเรียนไม่เคยเข้าถึงงานที่ส่งCREATED
หากนักเรียนสร้างการส่งแล้วแต่ยังไม่ได้ส่งTURNED_IN
หากนักเรียนส่งงานให้ครูแล้วRETURNED
หากครูส่งงานคืนให้นักเรียนRECLAIMED_BY_STUDENT
หากนักเรียนมี "ยกเลิกการส่ง" งานของตนเอง
ใช้ปลายทางนี้เพื่อตรวจหาสถานะงานของนักเรียนในส่วนเสริม คุณ จากนั้น อาจปรับมุมมองหรือตัวเลือกที่มีให้กับนักเรียน ทั้งนี้ขึ้นอยู่กับ แสดงผลสถานะ ซึ่งอาจรวมถึงฟีเจอร์ต่างๆ เช่น
- แสดงสถานะการส่งงานภายในส่วนเสริม ซึ่งอาจ ช่วยให้นักเรียนหลีกเลี่ยงความสับสนที่อาจเกิดขึ้นและมั่นใจได้ว่าจะไม่เกิดความผิดพลาด ส่งงานไม่สำเร็จ
- กำลังจำกัดสิทธิ์แก้ไขการส่ง หากงานมีสถานะ
CREATED
หรือRECLAIMED_BY_STUDENT
นักเรียนอาจได้รับอนุญาตให้แก้ไข ข้อมูลที่ส่ง หากงานมีสถานะTURNED_IN
หรือRETURNED
นักเรียนอาจไม่ได้รับอนุญาตให้แก้ไขงานที่ส่ง
คะแนนและไฟล์แนบหลายรายการ
คุณตั้งค่าคะแนนให้กับไฟล์แนบของส่วนเสริมได้ 1 รายการเท่านั้น
งาน หากครูสร้างไฟล์แนบประเภทกิจกรรมมากกว่า 1 ประเภท
เป็นค่า maxPoints
เฉพาะไฟล์แนบแรกเท่านั้นที่ตั้งค่า
คะแนนของงาน ไม่ได้ตั้งค่า maxPoints
หรือตั้งค่าเป็น 0 เป็น
ปิดใช้การส่งคืนเกรดสำหรับไฟล์แนบ
กำหนดคะแนนของงาน
คุณสามารถแก้ไขงานที่นักเรียนส่งได้โดยส่งคำขอ PATCH
ไปที่
ปลายทาง courses.courseWork.addOnAttachments.studentSubmissions
คำขอ
เนื้อหาต้องมีอินสแตนซ์ของ AddOnAttachmentStudentSubmission
ที่มีเมธอด
ค่าที่แก้ไข ตั้งค่าช่อง pointsEarned
เพื่อแก้ไขคะแนนที่ส่ง
ค่าที่ส่งใน pointsEarned
จะกลายเป็นคะแนนคร่าวๆ ที่แสดงต่อ
ครูใน UI ของ Classroom ครูจะแก้ไขคะแนนคร่าวๆ ได้
ก่อนส่งงานคืนให้นักเรียน ดูภาพรวมของการให้คะแนนใน
UI ของ Classroom เพื่อดูรายละเอียดเกี่ยวกับเกรด
นำเสนอต่อครู
โปรดทราบว่าคุณสามารถตั้งค่าคะแนนด้วย pointsEarned
ได้เฉพาะในกรณีต่อไปนี้
true:
- ไฟล์แนบต้องมีค่า
maxPoints
เป็นบวก - โดยส่วนเสริมต้องเป็นผู้สร้างต้นฉบับของไฟล์แนบ
โปรดทราบว่า คุณสามารถแก้ไข maxPoints
ของ AddOnAttachment
ที่สร้างไว้แล้ว
โดยการส่งคำขอ PATCH
ไปยังปลายทาง addOnAttachments
กำหนดคะแนนเมื่อใด
คุณจะมีตัวเลือกในการส่งคะแนนกลับไปยัง Google Classroom ความแตกต่างที่สำคัญคือ การที่คุณเลือกเก็บข้อมูลเข้าสู่ระบบของครู มีเพียงครูเท่านั้นที่สามารถแก้ไขคะแนน
มีช่วงเวลาเสริม 2 ช่วงที่คุณอาจสอบผ่าน Google Classroom: เมื่อนักเรียนทำงานเสร็จ หรือเมื่อครู เปิดงานของนักเรียนใน iframe การตรวจงานของนักเรียน
หากต้องการกำหนดคะแนนเมื่อนักเรียนทำงานเสร็จ คุณจะต้องจัดเก็บ ข้อมูลเข้าสู่ระบบแบบออฟไลน์ของครู แล้วเรียกคืนและใช้เพื่อแก้ไขคะแนน เมื่อนักเรียนทำงานเสร็จ วิธีนี้ทำให้ ประโยชน์:
- อัปเดตคะแนนได้อย่างราบรื่น ครูไม่จำเป็นต้องรับวิชาพิเศษ เพื่อทำให้คะแนนแสดงขึ้นใน UI ของ Classroom
- ให้ข้อมูลเชิงลึกแบบเรียลไทม์เกี่ยวกับความคืบหน้าของชั้นเรียนผ่านงาน เมื่อกำหนดคะแนนเมื่อนักเรียนส่งไฟล์แนบเสร็จแล้ว ครูก็จะเข้าใจได้ ของนักเรียน โดยไม่ต้องเปิดการส่งทุกครั้ง
โปรดทราบว่าวิธีนี้ยังอนุญาตให้ใช้วิธีการแบบไม่พร้อมกันในการให้คะแนน
การซิงค์ คุณอาจสำรวจ AddOnAttachmentStudentSubmission
เป็นระยะๆ
ปลายทางเพื่อตรวจหาเมื่อนักเรียนส่งงานแล้ว เมื่อมีการเปิดตัว
ส่งแล้ว ให้กำหนดคะแนนการส่งโดยใช้ข้อมูลเข้าสู่ระบบที่จัดเก็บไว้
หากไม่ต้องการโหลดข้อมูลรับรองของครูระหว่างเซสชันของนักเรียน คุณสามารถใช้ข้อมูลเข้าสู่ระบบของครูที่ใช้งานอยู่เมื่อโหลด ที่ส่งใน iframe ตรวจงานของนักเรียน อย่างไรก็ตาม วิธีนี้อาจไม่ได้มอบ ประสบการณ์ของผู้ใช้ที่ราบรื่นเป็นพิเศษเนื่องจากคะแนนใน UI ของ Classroom ไม่ได้อัปเดตแบบเรียลไทม์ และครูจะต้องเปิด iframe ตรวจงานของนักเรียนที่ส่ง
ตรวจหาการเปลี่ยนแปลงคะแนนของงาน
ครูสามารถแก้ไขการตั้งค่าคะแนนใน Classroom หลังจากสร้างงานแล้ว การแก้ไขดังกล่าวอาจ รวมข้อมูลต่อไปนี้
- การเปลี่ยนค่าคะแนนที่กำหนด
- เปลี่ยนค่า
maxPoints
ของงาน - การเปลี่ยนว่าควรให้คะแนนงานหรือไม่
หากต้องการดูการตั้งค่าการให้คะแนนปัจจุบันของงาน เราขอแนะนำให้ส่ง
คำขอ GET
ไปยังปลายทาง courses.courseWork
คำตอบประกอบด้วย
ค่า maxPoints
ปัจจุบัน งานที่ไม่ได้ให้คะแนนมีค่าว่างหรือ 0
maxPoints
หากคุณส่งคะแนนกลับไปที่ Classroom ให้ใช้
courses.courseWork.addOnAttachments.studentSubmissions
ปลายทางที่จะดึงข้อมูลหรือ
แก้ไขคะแนนสำหรับไฟล์แนบของส่วนเสริม ระบบจะกำหนดค่าคะแนนโดยใช้
pointsEarned
โปรดพิจารณาตรวจสอบและอัปเดตค่านี้หากจำเป็น
ถ้าผลิตภัณฑ์ของคุณอนุญาตให้ครูแก้ไขคะแนนของนักเรียนสำหรับ
กิจกรรม