אסטרטגיית הטמעה

בדף הזה נספק סקירה כללית קצרה על האינטראקציות העיקריות בין אפליקציית האינטרנט של התוסף לבין Google Classroom Add-ons API.

קובץ iframe מסוג Discovery של קבצים מצורפים

ה-iframe של Attachment Discovery הוא דף הנחיתה של המורים בתוסף. מומלץ לבצע את הפעולות הבאות לגבי התצוגה הזו:

להציג את ממשק המשתמש של גילוי התוכן או היצירה שלו.

אפשר גם לקבוע אם יהיה אפשר לשלוח תגובות לפריט בסטרימינג. למשל, אם אתם לא רוצים שהמורה יוכל להוסיף קבצים מסוג 'פעילות'. בודקים את הערך של פרמטר השאילתה itemType שהועבר כשהתוסף iframed נפתח. רק בתשובות מסוג courseWork אפשר לקבל תשובות מהתלמידים.
בהתאם לבחירות של המורים, שולחים בקשה אחת או יותר לתוסף create כדי לצרף למטלה קבצים מצורפים.

ה-iframe של תצוגת התלמידים התצוגה לתלמידים, ה-iframe של סקירת העבודות של התלמידים ושל התצוגה למורים נועדו להציג תוכן למשתמש במקום לשנות את המטלה ב-Classroom. כדאי לבצע את הפעולות הבאות בקשר לתצוגות האלה:

כשה-iframe נפתח, מקבלים את הסכמת המשתמש ל-OAuth ולאחר מכן מאמתים את התפקיד ומזהה הקובץ המצורף שלו.
כשנפתחת iframe, יוצרים courseWork.GetAddOnContextRequest, courseWorkMaterials.GetAddOnContextRequest או announcements.GetAddOnContextRequest על סמך itemType כדי לאמת את תפקיד המשתמש.
אם המשתמש הנוכחי הוא תלמיד, משייכים את submissionId מהתשובה לעבודה של התלמיד/ה. הדבר נדרש כדי להחזיר ציונים ולהציג את העבודות של התלמידים למורים בכלי למתן ציונים. הערך של submissionIds זהה בכל התצוגות.
אם ה-attachmentId כבר ידוע לתוסף, צריך להציג את ממשק המשתמש המתאים לקובץ המצורף.
אחרת, יכול להיות שהפוסט ההורה של הקובץ המצורף הזה הועתק מפוסט או מקורס אחר. משתמשים ב-copyHistory כדי לזהות את העותק העדכני ביותר שידוע לתוסף, מעתיקים ממנו את ההגדרות כדי ליצור מודל תואם חדש של הקובץ המצורף בצד התוסף. לאחר מכן, תוצג להם ממשק המשתמש המתאים להוספת קובץ.