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

หน้านี้จะให้ภาพรวมคร่าวๆ เกี่ยวกับการโต้ตอบที่สำคัญระหว่างเว็บแอปพลิเคชันของส่วนเสริมกับ API ของส่วนเสริมของ Google Classroom

iframe การค้นพบไฟล์แนบ

iframe การค้นพบไฟล์แนบคือหน้า Landing Page สำหรับครูในส่วนเสริม ลองดำเนินการต่อไปนี้กับมุมมองนี้

• แสดง UI การค้นพบหรือการสร้างเนื้อหา

  คุณสามารถเลือกที่จะระบุว่ารายการสตรีมจะยอมรับคำตอบของนักเรียนหรือไม่ เนื่องจากคุณอาจต้องการป้องกันไม่ให้ครูเพิ่มไฟล์แนบประเภทกิจกรรม ตรวจสอบค่าของพารามิเตอร์การค้นหา itemType ที่ส่งผ่านเมื่อ iframe ของส่วนเสริมเปิดขึ้น มีเพียงประเภท courseWork เท่านั้นที่จะยอมรับ คำตอบของนักเรียน

• ส่งคำขอส่วนเสริม create อย่างน้อย 1 รายการเพื่อเพิ่มไฟล์แนบในงาน โดยขึ้นอยู่กับการเลือกของครู

iframe อื่นๆ

iframe มุมมองของนักเรียน, iframe การตรวจสอบงานของนักเรียน และ iframe มุมมองของครู มีจุดประสงค์เพื่อนำเสนอเนื้อหาแก่ผู้ใช้ แทนที่จะแก้ไขงานใน Classroom ลองพิจารณาการดำเนินการต่อไปนี้ เกี่ยวกับมุมมองเหล่านี้

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