שילוב עם CourseWork

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

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

בדרך כלל משתמשים בנתיב השילוב הזה כדי ליצור מטלות ולתת להן ציונים באמצעות קישורים למשאבים מחוץ ל-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. אם הבעיות האלה מונעות מכם ליצור את המוצר, כדאי לנסות ליצור תוסף ל-Google Classroom במקום זאת.

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

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