หน้านี้จะกล่าวถึงรายละเอียดการใช้งานในการสร้างไฟล์แนบ การดำเนินการที่แนะนำเมื่อผู้ใช้เปิดไฟล์แนบ และการทำงานกับงานที่ส่งของนักเรียน โปรดทราบว่าคุณอาจต้องระบุพารามิเตอร์ที่เกี่ยวข้องกับไฟล์แนบเมื่อส่งคำขอเหล่านี้
สร้างไฟล์แนบ
สร้างไฟล์แนบโดยส่งคำขอ CREATE ไปยังปลายทาง courses.*.addOnAttachments.create ที่เหมาะสม คำขอต้องมีอินสแตนซ์ของ AddOnAttachment ในเนื้อหาของคำขอ
คุณต้องกรอกข้อมูลในช่องต่อไปนี้เมื่อสร้างไฟล์แนบ
title: ชื่อสตริงของไฟล์แนบteacherViewUri: URI สำหรับมุมมองของครูสำหรับไฟล์แนบstudentViewUri: URI สำหรับมุมมองนักเรียนของไฟล์แนบstudentWorkReviewUri: URI สำหรับครูเพื่อดูงานของนักเรียนในไฟล์แนบ ฟิลด์นี้จำเป็นสำหรับไฟล์แนบประเภทกิจกรรมเท่านั้น
คุณอาจต้องใส่ฟิลด์ที่ไม่บังคับต่อไปนี้
dueDateและdueTimeหากระบุวันที่ครบกำหนดของไฟล์แนบmaxPoints: คะแนนสูงสุดสำหรับไฟล์แนบ ต้องไม่ใช่ค่า 0 หากต้องการรองรับการส่งคะแนน ใช้กับไฟล์แนบประเภทกิจกรรมเท่านั้น
ดูรายละเอียดเพิ่มเติมเกี่ยวกับฟิลด์เหล่านี้ได้ในข้อมูลอ้างอิงแหล่งข้อมูล AddOnAttachment
ตรวจสอบข้อมูลเข้าสู่ระบบและบทบาทของผู้ใช้
iframe มุมมองนักเรียน, iframe รีวิวงานของนักเรียน และiframe มุมมองครูมีไว้เพื่อนำเสนอเนื้อหาแก่ผู้ใช้ ไม่ใช่เพื่อแก้ไขงานใน Classroom โปรดพิจารณาทำสิ่งต่อไปนี้เมื่อมุมมองใดมุมมองหนึ่งเหล่านี้เปิดอยู่
- รับข้อมูลเข้าสู่ระบบ OAuth ของผู้ใช้
- ส่งคําขอ
courseWork.getAddOnContext,courseWorkMaterials.getAddOnContextหรือannouncements.getAddOnContextตามitemTypeเพื่อตรวจสอบบทบาทของผู้ใช้ - ตรวจสอบการตอบกลับเพื่อดูว่ามี
TeacherContextหรือStudentContextอยู่หรือไม่ ระบบจะแสดงผลได้เพียงรายการเดียว ซึ่งสอดคล้องกับบทบาทของผู้ใช้ในหลักสูตร - หากผู้ใช้ปัจจุบันเป็นนักเรียนและ
itemTypeคือcourseWorkให้บันทึกsubmissionIdจากคำตอบที่มีงานของนักเรียนsubmissionIdsจะจับคู่กับ iframe ของส่วนเสริมต่างๆ และจำเป็นสำหรับการส่งคะแนนคืนและแสดงงานของนักเรียนให้ครูเห็นในเครื่องมือการให้คะแนน - หากส่วนเสริมรู้จัก
attachmentIdอยู่แล้ว ให้แสดง UI ไฟล์แนบที่เหมาะสม - ไม่เช่นนั้น ไฟล์แนบนี้ต้องคัดลอกมาจากรายการสตรีมหรือหลักสูตรอื่น ดูคำแนะนำเกี่ยวกับสถานการณ์นี้ในคู่มือการจัดการเนื้อหาที่คัดลอก
รายละเอียดการส่งงานของนักเรียน
เวิร์กโฟลว์การส่งข้อมูลทั่วไปมีขั้นตอนดังนี้
- นักเรียนเปิด
studentViewUriเพื่อทํากิจกรรมให้เสร็จ - ส่วนเสริมจะดึงข้อมูล
submissionIdจากเมธอดgetAddOnContextใช้ข้อมูลเข้าสู่ระบบของนักเรียน - นักพัฒนาส่วนเสริมจะจัดเก็บ
submissionIdและattachmentIdไว้เป็นตัวระบุที่ไม่ซ้ำกันของงานของนักเรียน ในกรณีที่ครูคัดลอกงานใน Classroom คุณสามารถใช้คีย์คอมโพสิทของพารามิเตอร์ 2 รายการนี้เพื่อแสดงไฟล์แนบใหม่ในงานที่คัดลอก ดูรายละเอียดเพิ่มเติมได้ที่หน้าเนื้อหาที่คัดลอก - ครูที่สนใจตรวจงานของนักเรียนจะเปิด
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 รายการซึ่งมีค่า maxPoints ไฟล์แนบรายการแรกเท่านั้นที่จะตั้งค่าคะแนนของงานได้ โปรดปล่อยค่า maxPoints ไว้หรือไม่กำหนดค่าเลย หรือตั้งค่าเป็น 0 เพื่อปิดใช้การส่งคะแนนสำหรับไฟล์แนบ
กำหนดคะแนนของงานที่ส่ง
คุณแก้ไขงานที่นักเรียนส่งมาได้โดยการส่งคำขอ PATCH ไปยังปลายทาง courses.courseWork.addOnAttachments.studentSubmissions เนื้อความของคำขอต้องมีอินสแตนซ์ของ AddOnAttachmentStudentSubmission ที่มีค่าที่แก้ไขแล้ว ตั้งค่าฟิลด์ pointsEarned เพื่อแก้ไขคะแนนของงานที่ส่ง
ค่าที่ส่งใน pointsEarned จะกลายเป็นคะแนนฉบับร่างที่ครูมองเห็นใน UI ของ Classroom ครูแก้ไขคะแนนฉบับร่างได้ก่อนที่จะส่งงานคืนให้กับนักเรียน ดูรายละเอียดเกี่ยวกับวิธีแสดงคะแนนให้ครูทราบได้ที่ภาพรวมของคะแนนใน UI ของ Classroom
โปรดทราบว่าคุณจะกำหนดคะแนนด้วย pointsEarned ได้ก็ต่อเมื่อมีคุณสมบัติตรงตามเงื่อนไขต่อไปนี้เท่านั้น
- ไฟล์แนบต้องมีค่า
maxPointsเป็นบวก - ส่วนเสริมต้องเป็นผู้สร้างไฟล์แนบเดิม
โปรดทราบว่าคุณยังแก้ไขmaxPointsค่าของ AddOnAttachment ที่สร้างขึ้นแล้วได้ด้วยการส่งคําขอ PATCH ไปยังปลายทาง addOnAttachments
กรณีที่ควรให้คะแนน
คุณมีตัวเลือกบางอย่างในการส่งคะแนนกลับไปที่ Google Classroom สิ่งที่แตกต่างอย่างสำคัญคือคุณเลือกที่จะจัดเก็บข้อมูลเข้าสู่ระบบของครูหรือไม่ เนื่องจากมีเพียงครูเท่านั้นที่แก้ไขคะแนนได้
มีช่วงเวลาเพิ่มเติม 2 ช่วงเวลาที่คุณอาจส่งคะแนนไปยัง Google Classroom ได้ ได้แก่ เมื่อนักเรียนส่งงานเสร็จแล้ว หรือเมื่อครูเปิดงานของนักเรียนใน iframe ของการตรวจสอบงานของนักเรียน
หากต้องการกำหนดคะแนนเมื่อนักเรียนทำงานเสร็จแล้ว คุณต้องจัดเก็บข้อมูลเข้าสู่ระบบแบบออฟไลน์ของครู จากนั้นเรียกข้อมูลดังกล่าวออกมาและใช้เพื่อแก้ไขคะแนนเมื่อนักเรียนทำงานเสร็จแล้ว วิธีการนี้มีประโยชน์บางอย่างดังนี้
- อัปเดตคะแนนได้อย่างราบรื่น ครูไม่จําเป็นต้องดําเนินการใดๆ เป็นพิเศษเพื่อให้คะแนนปรากฏใน UI ของ Classroom
- ให้ข้อมูลเชิงลึกแบบเรียลไทม์เกี่ยวกับความคืบหน้าของชั้นเรียนผ่านงาน การตั้งคะแนนเมื่อนักเรียนส่งไฟล์แนบแล้วจะช่วยให้ครูทราบระดับความเข้าใจของนักเรียนได้โดยไม่ต้องเปิดไฟล์ที่ส่งทุกรายการ
โปรดทราบว่าแนวทางนี้ยังใช้แนวทางแบบไม่พร้อมกันในการซิงค์คะแนนได้ด้วย คุณอาจทำการสำรวจAddOnAttachmentStudentSubmission
ปลายทางเป็นระยะๆ เพื่อตรวจหาว่านักเรียนส่งงานแล้วหรือยัง เมื่อส่งแล้ว ให้ตั้งค่าคะแนนของงานที่ส่งโดยใช้ข้อมูลเข้าสู่ระบบที่จัดเก็บไว้
หากไม่ต้องการโหลดข้อมูลเข้าสู่ระบบของผู้สอนระหว่างเซสชันของนักเรียน คุณสามารถใช้ข้อมูลเข้าสู่ระบบของผู้สอนที่ใช้งานอยู่เมื่อโหลดงานที่ส่งของนักเรียนใน iframe ของการตรวจสอบงานของนักเรียน อย่างไรก็ตาม การดำเนินการนี้อาจไม่ได้มอบประสบการณ์การใช้งานที่ราบรื่นมากนัก เนื่องจากคะแนนใน UI ของ Classroom จะไม่อัปเดตแบบเรียลไทม์ และครูจะต้องเปิด iframe ของ "รีวิวงานของนักเรียน" ของงานที่ส่งทุกรายการ
ตรวจหาการเปลี่ยนแปลงคะแนนของงาน
ครูแก้ไขการตั้งค่าคะแนนใน Classroom ได้หลังจากที่สร้างงานแล้ว การแก้ไขดังกล่าวอาจรวมถึงสิ่งต่อไปนี้
- การเปลี่ยนคะแนนเต็มที่กำหนดไว้
- การเปลี่ยนค่า
maxPointsของงาน - การเปลี่ยนว่าควรให้คะแนนงานหรือไม่
หากต้องการดูการตั้งค่าการให้คะแนนปัจจุบันของงาน เราขอแนะนำให้คุณส่งคำขอ GET ไปยังปลายทาง courses.courseWork การตอบกลับจะมีค่า maxPoints ปัจจุบัน งานที่ไม่มีคะแนนมีค่า Null หรือ 0
maxPoints
หากส่งคะแนนกลับไปที่ Classroom แล้ว ให้ใช้courses.courseWork.addOnAttachments.studentSubmissionsปลายทางเพื่อดึงข้อมูลหรือแก้ไขคะแนนสำหรับไฟล์แนบของส่วนเสริม ค่าคะแนนจะตั้งค่าโดยใช้ฟิลด์ pointsEarned ลองตรวจสอบและอัปเดตค่านี้ (หากจำเป็น) หากผลิตภัณฑ์ของคุณอนุญาตให้ครูแก้ไขคะแนนของนักเรียนสำหรับกิจกรรมหนึ่งๆ