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

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

จากภายในหลักสูตร Classroom ครูจะสร้างโพสต์ใหม่ (เช่น งาน ประกาศ หรือคำถาม) และเลือกส่วนเสริมจากรายการแบบเลื่อนลงของส่วนเสริม (รูปที่ 1)

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

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

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

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

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

เมื่อครูเลือกและสร้างไฟล์แนบเสร็จแล้ว ส่วนเสริมจะส่งpostMessageเพย์โหลดที่ขอให้ปิด iframe จากนั้น iframe จะปิดลงและครูจะเห็นไฟล์แนบ ซึ่งครูอาจเลือกที่จะดูตัวอย่างหรือนำออกจากงาน (รูปที่ 3) ครูจะสร้างงานให้เสร็จสมบูรณ์โดยมอบหมาย รายการในสตรีมให้นักเรียน

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

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

ข้อควรพิจารณาเกี่ยวกับประสบการณ์ของผู้ใช้

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

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

สถานะการออกใบอนุญาต

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