กลยุทธ์การติดตั้งใช้งาน

หน้านี้จะให้ภาพรวมคร่าวๆ เกี่ยวกับการโต้ตอบที่สำคัญระหว่างเว็บส่วนเสริม และ 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 ไฟล์แนบที่เหมาะสม