קובץ iframe של Discovery מסוג Discovery הוא התצוגה הראשונית שמוצגת למורה כשפותחים תוסף במהלך יצירת משימה ב-Classroom. קובץ מצורף הוא התוכן או הפעילות שאתם רוצים שהתלמידים יתכתבו איתם.
מתוך קורס ב-Classroom, המורה יוצר פוסט חדש (למשל מטלה, הודעה או שאלה) ובוחר תוסף מהתפריט הנפתח של התוספים. למשך זמן קצר (כמה שעות), Classroom מאפשר לתוסף להוסיף קבצים מצורפים לפרסום.
איור 1. תצוגה של יצירה של מטלה, כולל האפשרויות הנוספות שהמורה יכול לצרף.
אחרי שמורים בוחרים תוסף, מערכת Classroom יוצרת קובץ iframe מסוג Discovery של קבצים מצורפים וטוענת את כתובת ה-URL להפעלה של התוסף. כל פרמטר של שאילתה ב-iframe רלוונטי מועבר לכתובת ה-URL של ההשקה.
איור 2. דוגמה לממשק משתמש של גילוי קבצים מצורפים ב-iframe.
המורה משתמש באפליקציית האינטרנט של השותף, בתוך iframe, כדי לבחור קובץ מצורף. האפליקציה מבצעת קריאות ל-API של Classroom כדי לצרף את הקובץ למטלה. כשהמורה מסיים לבחור את הקבצים המצורפים, התוסף שולח עומס נתונים (payload) מסוג postMessage עם בקשה לסגירת ה-iframe.
ה-iframe נסגר והמורה יכול לראות עכשיו את הקבצים המצורפים. הוא יכול לצפות בתצוגה המקדימה שלהם או להסיר אותם מהמטלה.
איור 3. תצוגה של יצירת מטלה עם שלושה קבצים מצורפים מסוג 'פעילות'.
שיקולים לגבי חוויית המשתמש בתוך מסגרת ה-iframe
- בפתיחה הראשונית, התוסף צריך להציג למורה בקשה להיכנס לחשבון.
- צריך להשתמש ב-Google SSO לכל הקריאות ל-Classroom API. אם למוצר יש מערכת כניסה נפרדת, צריך לקשר את החשבונות.
- המורים צריכים להיות מסוגלים לראות תצוגה מקדימה של הקובץ המצורף בתוך ה-iframe לפני שהם מבצעים את הבחירה הסופית.
- למורים צריכה להיות אפשרות לחפש תוכן שניתן לצרף או לעיין בו.
- יכול להיות שהתוסף יספק מגוון תצוגות, כמו תוכן עדכני או התוכן שלי, ולסנן לפי כישורי הלמידה שלכם.
- התוסף צריך לאפשר יצירה של פריט חדש שאפשר לצרף מתוך ה-iframe.
למידע נוסף על דרישות חוויית המשתמש, אפשר לעיין ברשימת המשימות לדרישות השימוש בתוספי Classroom.
הצגת סטטוס הרישוי בתוך ה-iframe
אם נדרש רישיון כדי להשתמש בתוסף והמורה לא מחזיק ברישיון, חובה להציג למורה הודעה ברורה עם השלבים הבאים שצריך לבצע כדי לפתור את הבעיה. המטרה היא למנוע בלבול שעלול להיגרם כתוצאה מהגבלות הרישוי.
בנוסף, המלצנו שהתוסף:
- מציגה את רמת הרישיון של המורה ב-iframe של גילוי קבצים מצורפים.
- הסתרה או השבתה של תוכן שלא זמין למורה בגלל הגבלות ברמת הרישיון.