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

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

สำคัญ: คุณอาจพบกรณีพิเศษที่นี่ ผู้ใช้คนแรกที่เข้าถึงไฟล์แนบนี้อาจเป็นนักเรียน