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

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

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

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

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

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

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

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