iframe การค้นหาไฟล์แนบคือมุมมองเริ่มต้นที่แสดงต่อครูเมื่อ เปิดส่วนเสริมในระหว่างการสร้างงานใน Classroom ไฟล์แนบคือเนื้อหาหรือกิจกรรมที่คุณต้องการให้นักเรียน โต้ตอบด้วย
จากภายในหลักสูตร Classroom ครูจะสร้างโพสต์ใหม่ (เช่น งาน ประกาศ หรือคำถาม) และเลือกส่วนเสริมจากรายการแบบเลื่อนลงของส่วนเสริม (รูปที่ 1)
รูปที่ 1 มุมมองการสร้างงาน รวมถึงตัวเลือกส่วนเสริมที่อาจมีซึ่งครูสามารถแนบได้
เมื่อครูเลือกส่วนเสริม Classroom จะสร้าง iframe การค้นพบไฟล์แนบและโหลด URL การเปิดตัวของส่วนเสริม ระบบจะส่งพารามิเตอร์การค้นหา iframe ที่เกี่ยวข้องไปยัง URL การเปิดตัว (รูปที่ 2)
รูปที่ 2 ตัวอย่าง UI การค้นพบไฟล์แนบใน iframe
ให้คิดว่ามุมมองการค้นพบไฟล์แนบเป็นหน้า Landing Page สำหรับครูในส่วนเสริม โดยปกติแล้ว ครูจะใช้เว็บแอปพลิเคชันของพาร์ทเนอร์ภายใน iframe เพื่อเลือกเนื้อหาที่จะแนบไปกับรายการสตรีม แอปพลิเคชันส่วนเสริมอาจจำกัดเนื้อหาที่แสดงโดยขึ้นอยู่กับว่ารายการในสตรีมเป็นประกาศ งาน หรือสื่อการเรียนการสอน จากนั้นแอปพลิเคชันส่วนเสริมจะทำการเรียก Classroom API เพื่อสร้างและแนบไฟล์แนบกับงาน
เมื่อครูเลือกและสร้างไฟล์แนบเสร็จแล้ว
ส่วนเสริมจะส่งpostMessageเพย์โหลดที่ขอให้ปิด
iframe จากนั้น iframe จะปิดลงและครูจะเห็นไฟล์แนบ ซึ่งครูอาจเลือกที่จะดูตัวอย่างหรือนำออกจากงาน (รูปที่ 3) ครูจะสร้างงานให้เสร็จสมบูรณ์โดยการมอบหมาย
รายการในสตรีมให้นักเรียน
รูปที่ 3 มุมมองการสร้างงานที่มีไฟล์แนบส่วนเสริม 3 รายการประเภทกิจกรรม
ข้อควรพิจารณาเกี่ยวกับประสบการณ์ของผู้ใช้
- เมื่อเปิดครั้งแรก ส่วนเสริมต้องแจ้งให้ครูลงชื่อเข้าใช้
- การเรียกใช้ Classroom API ทั้งหมดต้องใช้การลงชื่อเพียงครั้งเดียวของ Google หากผลิตภัณฑ์มีระบบการเข้าสู่ระบบแยกต่างหาก คุณต้องลิงก์บัญชี
- ครูต้องดูตัวอย่างไฟล์แนบภายใน iframe ได้ก่อนที่จะเลือกไฟล์แนบขั้นสุดท้าย
- ครูควรค้นหาหรือเรียกดูเนื้อหาที่แนบได้
- ส่วนเสริมอาจมีมุมมองต่างๆ เช่น เนื้อหาล่าสุด เนื้อหาของฉัน และกรองตามทักษะการเรียนรู้
- ส่วนเสริมต้องมีความสามารถในการสร้าง รายการที่แนบได้ใหม่จากภายใน iframe
ดูรายละเอียดเพิ่มเติมเกี่ยวกับข้อกำหนดด้านประสบการณ์ของผู้ใช้ได้ในรายการตรวจสอบข้อกำหนดของส่วนเสริม Classroom
สถานะการออกใบอนุญาต
หากส่วนเสริมของคุณต้องใช้ใบอนุญาตสำหรับผลิตภัณฑ์ คุณควรแสดงข้อความที่ชัดเจนเพื่ออธิบายวิธีที่ครูซึ่งไม่มีใบอนุญาตจะแก้ไขสถานการณ์ดังกล่าวได้ นอกจากนี้ ให้พิจารณาซ่อนหรือปิดใช้เนื้อหาที่ครูไม่สามารถเข้าถึงได้เนื่องจากข้อจำกัดด้านการอนุญาตให้ใช้สิทธิ