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