מבוא

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

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

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

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

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

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

המטלה נוצרת.
המטלה משותפת עם התלמידים.
התלמיד או התלמידה משלימים את המטלה.
התלמיד/ה מגיש/ה את המטלה למורה.
המורים בודקים את המטלות ונותנים להן ציונים.

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

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

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