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