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