Learning Tools Interoperability (LTI) הוא מסגרת פתוחה ליצירת שילובים של צד שלישי במערכות לניהול למידה. תוספים ל-Classroom וכלים של LTI תומכים בתהליכי שימוש דומים, אבל שני המסגרות לא תואמות ישירות. במדריך הזה אנחנו משווים בין שני סוגי השילובים ומדגישים את ההבדלים העיקריים ביניהם. בנוסף, הוא מציע דרכים להשיג מסלולי משתמשים דומים כשמתאימים כלי LTI לעבודה כתוסף ל-Classroom.
אינטראקציות בין הפלטפורמה לבין הכלים
ההבדל העיקרי בין כלי LTI לבין תוספים ל-Classroom הוא האופן שבו המידע מועבר. בדרך כלל, כלי LTI משתמשים ב-HTTP POST כדי להעביר מטענים ייעודיים (payloads) לפלטפורמת LTI, בעוד שתוספים ל-Classroom יוצרים ומאחזרים משאבים באמצעות Google Classroom API בארכיטקטורת REST.
בטבלה הבאה מפורטות דרכים להשיג התנהגויות מרכזיות של כלי LTI באמצעות Google Classroom.
| תכונה | LTI | Classroom |
|---|---|---|
| יצירת מטלות | שירותים למטלות ולציונים | יצירת משאבים מסוג CourseWork ו-AddOnAttachment |
| פרסום ציונים | שירותים למטלות ולציונים | תיקון הגשות של תלמידים בגרסאות CourseWork ו-AddOnAttachment |
| הפעלת מסלולים | קישורי עומק | ציון מזהי URI במשאבי AddOnAttachment |
| קריאת רשימות התלמידים בקורס | שירותים להקצאת שמות ותפקידים | שליפת פרופילים של Student ושל Teacher בקורס |
התאמה של כלי LTI לתוסף ל-Classroom
להרבה אינטראקציות של LTI יש מקבילות במסגרת התוספים של Classroom. בקטעים הבאים מפורטים כמה מושגים חשובים והמלצות לפעולות.
הגדרת האפליקציה
כל האינטראקציות התוכנתיות עם Google Classroom מחייבות פרויקט ב-Google Cloud. תגדירו את דף האפליקציה באותו פרויקט בענן, שבו מוגדר איך התוסף של Classroom יופיע למשתמשי הקצה. תצטרכו לספק סמלים, להגדיר את השם והתיאור של האפליקציה ולקבוע את הרשאות הגישה להיקפי OAuth שהמוצר שלכם דורש.
התקנת אפליקציית התוסף מדף האפליקציה היא לרוב שלב ההגדרה היחיד שמשתמשי הקצה צריכים לבצע. זה דומה להפעלה ולפריסה של כלי LTI. משתמשי הקצה לא צריכים לבצע פעולות הרשמה או לנהל פרטי הגדרה, אבל יכול להיות שאדמין יצטרך לאשר את האפליקציה ב-Marketplace ולהגדיר הרשאות גישה לנתונים של צד שלישי.
המלצה: מומלץ לפעול לפי המדריך שלנו בנושא יצירה והגדרה של פרויקט בענן ב-Google Cloud לתוסף ל-Classroom. הכי חשוב: מציינים כתובת URL להפעלת התוסף בתור Attachment Discovery URI ב-Marketplace SDK. כתובת ה-URL הזו יכולה להיות זהה לנתיב הפעלה של כלי LTI קיים, כל עוד היא מפנה את המשתמש אל תהליך האימות המתאים.
תהליך האימות
ב-LTI נעשה שימוש בתהליך דו-שלבי שבו אפליקציית לקוח ושרת אימות מחליפים JWT חתום. המשתמשים לא צריכים להעניק לכלי גישה לנתונים שלהם, כי ההסכמה משתמעת כשמנהל מערכת מגדיר את הכלי.
לעומת זאת, תהליך OAuth של Google הוא תהליך עם 3 רגליים, שכולל את משתמש הקצה, אפליקציית לקוח חיצונית ושרת אימות. הלקוח מקבל טוקנים עם הסכמה מהמשתמש שמאפשרים גישה למשאבים של המשתמש ב-Google Classroom.
אפליקציית תוסף יכולה להשיג התנהגות דומה של JWT חתום עם 2 רגליים באמצעות חשבונות שירות. אלה חשבונות ששייכים לאפליקציה ולא למשתמשים פרטיים, והם יכולים לבצע פעולות בלי הסכמת המשתמשים. כדי להשתמש בחשבונות שירות, צריך להגדיר ולנהל אותם דרך חשבון אדמין. לא מומלץ להשתמש בחשבונות שירות עם הענקת הרשאות גישה ברמת הדומיין, כי הם עלולים לשמש כווקטורים להתנהלות פוגעת. פרטים נוספים זמינים במדריך שלנו בנושא הענקת גישה ברמת הדומיין בשילוב עם Google Classroom.
המלצה: כשכתובת URL שמשויכת לכלי או לתוסף שלכם מקבלת בקשה נכנסת, כדאי לבדוק את הבקשה כדי לראות אם יש בה פרמטרים של שאילתה של תוסף ל-Classroom. אם יש כזה, משתמשים ב-Google Identity SDK כדי לקבל פרטי כניסה לגישה עבור המשתמש. שומרים את פרטי הכניסה בסשן של המשתמש ומשתמשים בהם כדי לבצע בקשות Classroom API נוספות. אם פרמטרי השאילתה לא קיימים, צריך להשתמש בבקשות HTTP כדי ליצור אינטראקציה עם נקודות הקצה של LTI בפלטפורמה.
יצירת תוכן לתוספים ב-Google Classroom
תוספים ל-Classroom תומכים בסוג אחד של תוכן: קישורי URL לדפים שמתארחים באופן חיצוני. הקישורים האלה מופיעים במשאבי AddOnAttachment, שבהם מוגדרים נתיבי האינטרנט שייפתחו כשמשתמש יוצר אינטראקציה עם התוסף. כל כתובת URL נפתחת בתרחישים ספציפיים. פרטים מלאים זמינים במדריכים שלנו בנושא iframe. כתובות ה-URL האלה מקבילות לקישורי משאבים של LTI.
תוספים ל-Classroom לא תומכים בסוגי תוכן אחרים, כמו קבצים, תמונות או קטעי HTML.
המלצה: כשמשתמש בוחר תוכן במוצר שלכם, צריך לקבל את פרטי הכניסה שלו ב-OAuth ולשלוח בקשת AddOnAttachments.create. הבקשה צריכה להכיל אובייקט AddOnAttachment עם כתובות ה-URL לתצוגת התלמיד, לתצוגת המורה ו (אופציונלית) לתצוגת מתן הציונים. שימו לב שיש נקודות קצה נפרדות ל-API ליצירת קבצים מצורפים להודעות לכיתה, למטלות או לחומרי לימוד. רק קבצים מצורפים שנוצרו במטלות יכולים להופיע בתצוגת מתן הציונים, כי זהו הסוג היחיד של פריט בעדכונים בכיתה שאפשר להגיש לו עבודה.
השוואה בין תכונות של מסגרות
מיקומי שילוב
תוספים ל-Classroom יוצרים קבצים מצורפים בהודעות לכיתה, במטלות ובחומרי לימוד לקורס. אלה הפריטים שמופיעים בכרטיסייה 'עדכונים' של קורס בממשק המשתמש של Classroom.
כדי להתחיל ליצור קובץ מצורף של תוסף, המורים בוחרים תוסף בכלי לבחירת קבצים בתהליך יצירת המטלה. במדריכים בנושא iframes מוסבר בפירוט על כל תצוגה שמוצגת למשתמשים.
לחלופין, מפתחים יכולים ליצור מטלות באופן פרוגרמטי עם קבצים מצורפים של תוספים. לפרטים מומלץ לעיין במדריך שלנו בנושא יצירת קבצים מצורפים מחוץ ל-Google Classroom.
הצגת מידע על ההקשר
אפליקציית Classroom מוסיפה כמה פרמטרים של שאילתה לכל כתובת URL כשפותחים נתיב של תוסף. הם תמיד כוללים את סוג הפריט בפיד ומזהים של הקורס והפריט בפיד. יכול להיות שיוצג מידע נוסף בהתאם לתצוגת ה-iframe, כמו מזהים של קבצים מצורפים או של הגשות, טוקן לאישור יצירת קובץ מצורף או כתובת URL לשדרוג מקישור לקובץ מצורף של תוסף.
כברירת מחדל, Classroom לא מעביר מידע על המשתמש או על המוסד. אפשר לקבל מידע על המשתמש ממקור המידע UserProfile ב-Classroom API, כולל מזהה משתמש. אם המשתמש הוא אדמין בדומיין, אפשר לקבל מידע על המוסד באמצעות Workspace Admin SDK.
אימות והרשאה
תוספים ל-Classroom חייבים להשתמש בכניסה באמצעות חשבון Google לאימות משתמשים. אחרי שהמשתמשים נכנסים לחשבון, הם נותנים הרשאה לאפליקציה שלכם באמצעות היקפי הרשאות של OAuth 2.0. האפליקציה יכולה להשתמש בכל שילוב של היקפי הרשאות OAuth זמינים.
גילוי והגדרה של אפליקציות
המשתמשים מוצאים תוספים ל-Classroom ומתקינים אותם דרך Google Workspace Marketplace. התקנה בלחיצה אחת מאפשרת למורים להשתמש באפליקציית תוסף. אדמינים יכולים גם להתקין את אפליקציית התוסף לכל המורים ביחידה ארגונית או בדומיין. אחרי מכן, כל התלמידים בקורס יכולים לגשת לקבצים המצורפים שנוצרו באמצעות האפליקציה. משתמשי הקצה לא צריכים לנהל אסימונים, מפתחות או מזהים עבור תוספים ספציפיים ל-Classroom.
חוויית משתמש ותהליך המוצר
במקרים רבים, תהליך המוצר הקיים של כלי LTI מתאים כתוסף ל-Classroom. בדומה לכלי LTI, תוסף ל-Classroom מאפשר לכם ליצור ולנהל קישורים לתוכן שלכם בפלטפורמה שלנו. קובץ מצורף של תוסף ל-Classroom דומה לקישורי עומק של LTI. אם כלי LTI יוצר כתובות URL שמפנות לתוכן שמתארח אצלכם, הוא אמור לפעול היטב כתוסף ל-Classroom.
מתן ציון לעבודות של תלמידים
אפשר לראות קבצים מצורפים של תוספים ל-Classroom ולתת עליהם ציונים בתצוגת כלי הציונים של Classroom. כשמצרפים תוכן שדורש הגשה של תלמיד או תלמידה, צריך לספק student_work_review_uri שבו איש או אשת סגל יכולים לראות את העבודה של תלמיד או תלמידה מסוימים ולתת לה ציון. ההגדרה הזו שונה מ-LTI, שבו כלי מגדיר רק target_link_uri שמשותף למורים ולתלמידים. ההטמעה של תוספי Classroom דומה מאוד לשירות לבדיקת הגשות LTI שיושק בקרוב.