หน้านี้จะให้ภาพรวมคร่าวๆ เกี่ยวกับการโต้ตอบที่สำคัญระหว่างเว็บแอปพลิเคชันของส่วนเสริมกับ API ของส่วนเสริมของ Google Classroom
iframe การค้นพบไฟล์แนบ
iframe การค้นพบไฟล์แนบคือหน้า Landing Page สำหรับครูในส่วนเสริม ลองดำเนินการต่อไปนี้กับมุมมองนี้
แสดง UI การค้นพบหรือการสร้างเนื้อหา
คุณสามารถเลือกที่จะระบุว่ารายการสตรีมจะยอมรับคำตอบของนักเรียนหรือไม่ เนื่องจากคุณอาจต้องการป้องกันไม่ให้ครูเพิ่มไฟล์แนบประเภทกิจกรรม ตรวจสอบค่าของพารามิเตอร์การค้นหา
itemType
ที่ส่งผ่านเมื่อ iframe ของส่วนเสริมเปิดขึ้น มีเพียงประเภทcourseWork
เท่านั้นที่จะยอมรับ คำตอบของนักเรียนส่งคำขอส่วนเสริม
create
อย่างน้อย 1 รายการเพื่อเพิ่มไฟล์แนบในงาน โดยขึ้นอยู่กับการเลือกของครู
iframe อื่นๆ
iframe มุมมองของนักเรียน, iframe การตรวจสอบงานของนักเรียน และ iframe มุมมองของครู มีจุดประสงค์เพื่อนำเสนอเนื้อหาแก่ผู้ใช้ แทนที่จะแก้ไขงานใน Classroom ลองพิจารณาการดำเนินการต่อไปนี้ เกี่ยวกับมุมมองเหล่านี้
- เมื่อ iframe เปิดขึ้น ให้ขอความยินยอม OAuth ของผู้ใช้ จากนั้นตรวจสอบบทบาทและรหัสไฟล์แนบ
- เมื่อ iframe เปิดขึ้น ให้สร้าง
courseWork.GetAddOnContextRequest
,courseWorkMaterials.GetAddOnContextRequest
หรือannouncements.GetAddOnContextRequest
ตามitemType
เพื่อตรวจสอบบทบาทของผู้ใช้ - หากผู้ใช้ปัจจุบันเป็นนักเรียน ให้เชื่อมโยง
submissionId
จากคำตอบกับงานของนักเรียน ซึ่งจำเป็นสำหรับการส่งเกรดกลับมาและการแสดงงานของนักเรียนแก่ครูในเครื่องมือให้คะแนน เนื่องจากการจับคู่submissionIds
กับการแสดงผลแต่ละครั้ง - หากส่วนเสริมรู้จัก
attachmentId
อยู่แล้ว ให้แสดง UI ของไฟล์แนบที่เหมาะสม - มิฉะนั้น ต้องเป็นกรณีที่โพสต์หลักของไฟล์แนบนี้ถูกคัดลอกจากโพสต์หรือหลักสูตรอื่น ใช้
copyHistory
เพื่อระบุสำเนาล่าสุดที่ส่วนเสริมรับรู้ และคัดลอกการตั้งค่าจากส่วนเสริมเพื่อสร้างโมเดลใหม่ที่เกี่ยวข้องของไฟล์แนบในฝั่งส่วนเสริม จากนั้นแสดง UI ไฟล์แนบที่เหมาะสม