מבוא

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

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

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

הסבר על מחזור החיים של מטלות

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

יש חמישה שלבים עיקריים שחשוב לזכור כשמשלבים כלי עם כלי המשימות של Classroom:

  1. המטלה נוצרת.
  2. המטלה משותפת עם התלמידים.
  3. התלמידים משלימים את המטלה.
  4. התלמיד/ה שולח/ת את המטלה למורה.
  5. המורים בודקים את המטלות ונותנים להן ציונים.

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

תרשים שמציג את חמשת השלבים של מטלה

הטמעה

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

<script src="https://apis.google.com/js/platform.js" async defer></script>
<g:sharetoclassroom url="http://url-to-share" size="32"></g:sharetoclassroom>

לעומת זאת, CourseWork API הוא חלק מ-Google Classroom API בארכיטקטורת REST, שנדרשת בו הגדרה והפעלה של מפתחות API באמצעות מסוף Google Cloud, ויישום שיטות מומלצות לשילוב עם API. הבעיה הזו פחות רלוונטית אם הפלטפורמה שלכם כבר משתמשת בפונקציונליות אחרת של Classroom API, כמו ניהול רשימות תלמידים.

יצירה ושיתוף של מטלות

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

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

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

סוג הפוסט כפתור שיתוף CourseWork API
מטלה X X
בוחן
שאלה: תשובה קצרה X X
שאלה: שאלה אמריקאית X X
חומר X X
הודעה X X

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

שינוי מטלות

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

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

סנכרון אוטומטי של מטלות

באמצעות התראות Push של Pub/Sub, האפליקציה שלכם יכולה להירשם לקבלת התראות שמפעילות אירוע כשמתבצעים שינויים בפריטים של כלי המשימות ובקבצים שהתלמידים משייכים להם. ההרשאה הזו מאפשרת לאפליקציה לסנכרן בקלות את המטלות, כי היא מבטלת את הצורך בבדיקות מתמשכות כדי לראות אם התוכן עודכן ב-Classroom.

השלמה והגשה של מטלות

כל מטלה משויכת ל-N הגשות של תלמידים, כאשר N הוא מספר התלמידים שהמטלה הוקצתה להם. במילים אחרות, לכל מטלה יש עבודה שהוגשה על ידי כל תלמיד, שאפשר לגשת אליה באמצעות מזהה ייחודי. העבודות האלה של התלמידים נוצרות באופן אוטומטי, ואפשר לאחזר אותן באמצעות נקודות הקצה GET ו-LIST של עבודות התלמידים באפליקציה.

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

סיום תהליך העבודה של הסטודנטים

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

בדיקה ומתן ציונים למטלות

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

בשלב הזה, כפתור השיתוף לא מאפשר לתת ציונים למטלות ולהחזיר אותן. אף על פי שתכונות כמו הערות על הגשות של תלמידים לא נחשפות כרגע דרך ה-API, אפשר לתת ציונים ולהחזיר אותם לתלמידים דרך נקודות הקצה studentSubmissions.patch ו-studentSubmissions.return. אפשר לציין ציונים רק לפריטים בפיד של עבודות בקורס (סוגי מטלות ושאלות). הם זמינים רק בפורמט מספרי ואפשר להקצות אותם כציון טיוטה או כציון סופי.

סיכום ההבדלים

כדי לסכם את כל מה שנבדק בקטעים הקודמים, בטבלה שלמטה מוצגת השוואה בין לחצן השיתוף לבין CourseWork API בארבע הקטגוריות שצוינו למעלה: הטמעה, יצירה ושיתוף של מטלות, השלחה של מטלות ובדיקה ומתן ציונים למטלות.

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