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

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

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

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

• כשפותחים קובץ iframe מסוג Discovery, יוצרים תג courseWork.GetAddOnContextRequest, courseWorkMaterials.GetAddOnContextRequest או announcements.GetAddOnContextRequest על סמך itemType כדי לאמת את תפקיד המשתמש ולקבל את הערך supportsStudentWork.
• הצגת ממשק המשתמש לגילוי תוכן או ליצירת תוכן. יכול להיות להשמיט מתגובת האימות של ההפעלה קבצים מצורפים מסוג פעילות, על סמך הערך של supportsStudentWork.
• בהתאם לבחירות של המורים, שולחים בקשה אחת או יותר מסוג create להוספת קבצים למטלה.

מסגרות iframe אחרות

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

• כשנפתח iframe, צריך לקבל את הסכמת המשתמש ל-OAuth ולאחר מכן לאמת את התפקיד שלו ואת מזהה הקובץ המצורף.

  • אם המשתמש הנוכחי הוא תלמיד, צריך לשייך את submissionId מהתגובה לעבודה של התלמיד. צריך לעשות זאת כדי להחזיר ציונים ולהציג עבודות של תלמידים למורים בכלי למתן ציונים. הערך submissionIds תואם בין התצוגות.
  • אם attachmentId כבר מוכר לתוסף, צריך להציג את ממשק המשתמש המתאים לצירוף.
  • אחרת, סביר להניח שפוסט ההורה של הקובץ המצורף הזה הועתק מפוסט אחר או מקורס אחר. בעזרת copyHistory אפשר לזהות את העותק האחרון שהתוסף מכיר, ולהעתיק ממנו את ההגדרות, כדי ליצור מודל מתאים חדש של הקובץ המצורף בצד של התוסף. לאחר מכן, מציגים את ממשק המשתמש המתאים לקבצים מצורפים.
  חשוב: יכול להיות שתיתקלו כאן במקרי קצה, כי המשתמש הראשון שיגש לקובץ המצורף הוא סטודנט.