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