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

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

ครูจะสร้างโพสต์ใหม่ (เช่น งาน ประกาศ หรือคำถาม) จากในหลักสูตรของ Classroom และเลือกส่วนเสริมจากรายการแบบเลื่อนลงของส่วนเสริม Classroom จะอนุญาตให้ส่วนเสริมเพิ่มไฟล์แนบในโพสต์ได้ในช่วงเวลาสั้นๆ (ตามลำดับชั่วโมง)

มุมมองการสร้างงาน รวมถึงตัวเลือกส่วนเสริมที่เป็นไปได้ซึ่งครูสามารถแนบได้ รูปที่ 1 มุมมองการสร้างงาน รวมถึงตัวเลือกส่วนเสริมที่เป็นไปได้ซึ่งครูสามารถแนบได้

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

ตัวอย่าง UI การค้นพบไฟล์แนบ

รูปที่ 2 ตัวอย่าง UI การค้นพบไฟล์แนบใน iframe

ครูจะใช้เว็บแอปพลิเคชันของพาร์ทเนอร์ใน iframe เพื่อเลือกไฟล์แนบ แอปจะเรียกใช้ Classroom API เพื่อแนบไฟล์แนบไปกับงาน เมื่อครูเลือกไฟล์แนบเสร็จแล้ว ส่วนเสริมจะส่งเพย์โหลด postMessage เพื่อขอให้ปิด iframe

iframe จะปิดและครูอาจเห็นไฟล์แนบที่สามารถเลือกดูตัวอย่างหรือนำออกจากงานได้

มุมมองการสร้างงาน

รูปที่ 3 มุมมองการสร้างงานที่มีไฟล์แนบเสริมประเภทกิจกรรม 3 รายการ

ข้อควรพิจารณาเกี่ยวกับ UX ใน iframe

  • เมื่อเปิดครั้งแรก ส่วนเสริมต้องแจ้งให้ครูลงชื่อเข้าใช้
  • ต้องใช้การลงชื่อเพียงครั้งเดียวของ Google สำหรับการเรียก Classroom API ทั้งหมด หากผลิตภัณฑ์มีระบบเข้าสู่ระบบแยกต่างหาก คุณต้องลิงก์บัญชี
  • ครูต้องดูตัวอย่างไฟล์แนบใน iframe ได้ก่อนที่จะทำการเลือกขั้นสุดท้าย
  • ครูควรสามารถค้นหาหรือเรียกดูเนื้อหาที่แนบได้
  • ส่วนเสริมอาจให้มุมมองที่หลากหลาย เช่น เนื้อหาล่าสุด เนื้อหาของฉัน และกรองตามทักษะการเรียนรู้
  • ส่วนเสริมต้องสร้างความสามารถในการสร้างรายการที่แนบใหม่ได้จากภายใน iframe

โปรดดูรายละเอียดเพิ่มเติมเกี่ยวกับข้อกำหนดของ UX ในรายการตรวจสอบข้อกำหนดที่เป็นส่วนเสริมของ Classroom

แสดงสถานะการอนุญาตให้ใช้สิทธิภายใน iframe

หากส่วนเสริมจำเป็นต้องมีใบอนุญาต แต่ครูไม่มี จะต้องมีแสดงข้อความที่ชัดเจนให้ดูแก่ครูเพื่อแจ้งให้ทราบถึงขั้นตอนถัดไปที่เหมาะสมเพื่อเยียวยาสถานการณ์ ทั้งนี้เพื่อป้องกันความสับสนที่อาจเกิดขึ้น จากข้อจำกัดในการอนุญาตให้ใช้สิทธิ

เราขอแนะนำให้คุณเพิ่มส่วนเสริมในลักษณะต่อไปนี้

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