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

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

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

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

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

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

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

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