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

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

iframe של Attachment Discovery

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

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

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

  • על סמך הבחירות של המורה, שולחים בקשה אחת או יותר להוספת קבצים למטלה באמצעות התוסף create.

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

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

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