โต้ตอบกับไฟล์แนบ

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

สร้างไฟล์แนบ

สร้างไฟล์แนบโดยส่งคำขอ CREATE ไปยัง อุปกรณ์ปลายทาง courses.*.addOnAttachments.create คำขอของคุณต้องมี อินสแตนซ์ของ AddOnAttachment ในเนื้อหาคำขอ

ต้องกรอกข้อมูลในช่องต่อไปนี้เมื่อสร้างไฟล์แนบ

  • title: ชื่อสตริงของไฟล์แนบ
  • teacherViewUri: URI สำหรับมุมมองครูของไฟล์แนบ
  • studentViewUri: URI สำหรับมุมมองของนักเรียนของไฟล์แนบ
  • studentWorkReviewUri: URI สำหรับครูเพื่อดูงานของนักเรียน ไฟล์แนบ ต้องกรอกข้อมูลในช่องนี้สำหรับไฟล์แนบประเภทกิจกรรมเท่านั้น

คุณควรใส่ช่องที่ไม่บังคับต่อไปนี้

  • dueDate และ dueTime หากระบุว่าต้องส่งไฟล์แนบเมื่อใด
  • maxPoints: คะแนนสูงสุดสำหรับไฟล์แนบ ต้องเป็นค่าที่ไม่ใช่ 0 หากต้องการรองรับการส่งคืนเกรด ใช้กับไฟล์แนบประเภทกิจกรรม เท่านั้น

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

รายละเอียดการส่งงานของนักเรียน

ขั้นตอนการทำงานการส่งทั่วไปมีดังนี้

  1. นักเรียนเปิด studentViewUri เพื่อทำกิจกรรมให้เสร็จ
  2. ส่วนเสริมเรียกข้อมูล submissionId จากเมธอด getAddOnContext โดยใช้ข้อมูลเข้าสู่ระบบของนักเรียน
  3. submissionId และ attachmentId จะจัดเก็บโดยส่วนเสริม เป็นตัวระบุที่ไม่ซ้ำกันสำหรับงานของนักเรียน ในกรณีที่ เมื่อครูคัดลอกงานใน Classroom คุณจะสามารถใช้ คีย์ผสมของพารามิเตอร์ทั้งสองนี้เพื่อแสดงไฟล์แนบใหม่ใน คัดลอกงานแล้ว ดูรายละเอียดเพิ่มเติมได้ที่หน้าของเราเกี่ยวกับเนื้อหาที่คัดลอกมา
  4. ครูที่สนใจตรวจงานของนักเรียนเปิดตัว studentWorkReviewUri คำขอประกอบด้วยพารามิเตอร์การค้นหาต่อไปนี้ courseId, itemId, itemType, attachmentId และ submissionId
  5. นักพัฒนาส่วนเสริมจะใช้รหัสทั้ง 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 โปรดพิจารณาตรวจสอบและอัปเดตค่านี้หากจำเป็น ถ้าผลิตภัณฑ์ของคุณอนุญาตให้ครูแก้ไขคะแนนของนักเรียนสำหรับ กิจกรรม