שילוב עם CourseWork

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

השילוב הזה משמש בדרך כלל ליצירה ולמתן ציונים למטלות עם קישורים למקורות מידע מחוץ ל-Classroom. הוא מספק גישה רחבה יותר למפתחים לניהול עבודות בהשוואה ל לחצני השיתוף ב-Classroom.

איך זה עובד

התכונה המרכזית של שילוב CourseWork היא יצירה וניהול של מטלות, הודעות וחומרי לימוד באמצעות Classroom API.

דוגמה אחת למסלול נפוץ של משתמשים שמתאפשר בזכות שילוב של CourseWork היא לאפשר למורים לגלות תוכן, להקצות אותו ולתת לו ציון מתוך האתר או האפליקציה שלכם:

1. משתמש עם הרשאת מורה מתחבר לאתר שלכם.
2. המורה מוצא או יוצר תוכן שהוא רוצה לשתף עם הכיתה. המורה לוחץ על לחצן באתר שלכם כדי לשלוח את התוכן הזה אל Google Classroom.
3. האפליקציה שלך שולחת בקשה אל courses.courseWork.create. הבקשה מכילה אובייקט CourseWork בגוף שלה, שמכיל:
   • מזהה הקורס של היעד.
   • שם המטלה.
   • תיאור המטלה.
   • link Material עם כתובת ה-URL של התוכן שנבחר על ידי המורה.
   • אופציונלי: הציון המקסימלי שאפשר לקבל על התוכן שנבחר.
4. מטלה חדשה מופיעה ב-Classroom עם קישור מצורף. הקישור מתייחס לכתובת ה-URL שצוינה בבקשת create. דוגמה מופיעה באיור 1.
5. עמודה חדשה של המטלה מופיעה גם בגיליון הציונים ב-Classroom, כולל הציון המקסימלי אם הוא צוין.
6. התלמידים מקבלים את המטלה ולוחצים על הסמל link Material כדי לפתוח את כתובת ה-URL שסיפקתם בכרטיסייה חדשה ולצפות בתוכן באתר שלכם או להשלים אותו. אופציונלי: מספקים לתלמידים אמצעי בקרה להגשת המטלה.
7. אפשר גם לשלוח בקשה אל courses.courseWork.studentSubmissions.modifyAttachments כדי להוסיף קבצים מצורפים להגשה של תלמיד, כמו קובץ Google Drive או link Material שמפנה לעבודה של התלמיד באתר שלכם.
8. אופציונלי, אפשר לשלוח בקשה אל courses.courseWork.studentSubmissions.patch כדי להגדיר את הציון של התלמיד/ה למטלה.

איור 1. תצוגה למורים בעריכת מטלה שlink Materialנוצרה על ידי שילוב של CourseWork.

אפשר גם להתקשר אל courses.announcements.create או אל courses.courseWorkMaterials.create כדי ליצור הודעה לכיתה או חומר לימוד במקום מטלה. במאמרים יצירה וניהול של חומרי לימוד והגדרת ציונים ועדכון שלהם מופיעים תיאורים מפורטים של הפעולות הרלוונטיות ב-Classroom API.

שיקולים

לפני שמחליטים אם שילוב של CourseWork הוא הבחירה הנכונה לצרכים של המוצר, כדאי לקחת בחשבון את הנקודות הבאות.

• צריך לתת הרשאה למשתמש ולבקש את הסכמתו. אתם שולחים בקשות ל-API בשם המשתמש. לדוגמה, אתם לא יכולים ליצור עבודה לכיתה בכל קורס ב-Google Classroom, אלא רק בקורסים שבהם המשתמש המורשה מלמד.
• צריך לאפשר למשתמש לבחור קורס כדי לקבל את התוכן. אפשר להשתמש ב-courses.list כדי לקבל רשימה של הקורסים שהמשתמש מלמד, ואז לאפשר למשתמש לבחור קורס אחד או יותר מהרשימה.
• כשמשתמש לוחץ על link Material ב-Classroom, הקישור נפתח בכרטיסייה חדשה. השרת שלכם לא יקבל מידע מ-Classroom כשהכתובת תפתח.
• מורה יכול לשנות או למחוק את חומרי הלימוד באופן עצמאי, בלי קשר למפתח. כלומר, יכול להיות שהידע של מפתח מסוים בנושאים שנלמדים בקורס כבר לא יהיה עדכני. אם חשוב לכם לדעת על שינויים במטלות, כדאי להגדיר התראות פוש לגבי שינויים במטלות.
• מורה יכול ליצור חומרי לימוד בממשק המשתמש של Classroom באמצעות קישורים שהודבקו לכתובות URL באתר שלכם. הבעלות על עבודות שנוצרו בדרך הזו היא של המורה בלבד, ולכן לא תוכלו להציג, לשנות או להגדיר ציונים לעבודות שהוגשו באמצעות Classroom API.