שילוב עם 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 כדי להגדיר את הציון של התלמיד למטלה.

עריכת מטלה ב-CourseWork עם צירוף של קישור לחומר

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

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

לתשומת ליבכם

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

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