מטלות ב-Classroom נקראות 'פריטי CourseWork'. אפשר למצוא אותם בדף 'עבודות' בכל קורס ב-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 הוא חלק מממשק ה-API ל-REST של Google Classroom. כדי להשתמש בו צריך להגדיר ולהפעיל מפתחות API במסוף Google Cloud, ולפעול בהתאם לשיטות המומלצות לשילוב עם API. זה פחות מדאיג אם הפלטפורמה שלכם כבר משתמשת בפונקציות אחרות של Classroom API, כמו ניהול רשימת לקוחות.
יצירה ושיתוף של מטלות
גם לחצן השיתוף וגם ה-CourseWork API מאפשרים לבצע את שני השלבים הראשונים בתהליך העבודה, ליצור מטלות ולשתף אותן עם התלמידים, אבל יש כמה הבדלים חשובים שכדאי לחשוב עליהם לפני שבוחרים פתרון.
שני הפתרונות המרכזיים מאפשרים לפרסם קישורים או קבצים כמטלות ב-Classroom. זהו כלי רב-עוצמה למורים שאחרת היו נאלצים לבצע זרימת עבודה של העתקה והדבקה בין Google Classroom לבין האפליקציה של צד שלישי. שני הפתרונות תומכים ביכולת לפרסם תוכן כמטלה, אבל כדאי לבדוק אם לאפליקציה שלכם נדרשת גמישות כדי לפרסם את התוכן הזה כסוגים אחרים של עבודות כיתה, או אפילו להציג הודעה לכיתה.
שתי ההצעות מציגות את כל סוגי הפוסטים ב-Classroom, מלבד מטלות בבוחן. בהמשך ניתן למצוא סיכום של כל סוגי הפוסטים ובדיקה אם הם נחשפו.
| סוג פוסט | לחצן שיתוף | ממשק API ל-CourseWork |
|---|---|---|
| מטלה | X | X |
| בוחן | ||
| שאלה: תשובה קצרה | X | X |
| שאלה: שאלה אמריקאית | X | X |
| חומר | X | X |
| הודעה | X | X |
אפשר גם לציין באופן פרוגרמטי פונקציונליות כמו הוספת כותרת ותיאור, על ידי האפליקציה בשני הפתרונות. השילוב של לחצן השיתוף מאפשר למשתמשים להגדיר שדות כמו תאריך יעד, נושא, מצב אישי ומספר נקודות בתיבת הדו-שיח הקופצת, אבל אי אפשר להגדיר אותם באופן פרוגרמטי על ידי אפליקציה של צד שלישי. לעומת זאת, ה-API חושף את כל השדות האלה לקריאה ולכתיבה.
שינוי מטלות
ביטול הצורך של המשתמשים לסנכרן ידנית פרטים משתנים במטלות שלהם הוא אחד מהיתרונות של השילוב עם Classroom API. ללחצן השיתוף אין פונקציונליות לעדכון או למחיקה של מטלות באופן פרוגרמטי, ולכן המשתמש יצטרך לבצע שינויים דרך ממשק המשתמש של Classroom.
ה-CourseWork API מאפשר לשנות ולמחוק מטלות שהאפליקציה יצרה, וגם לאחזר פרטים על מטלות שפורסמו בקורסים של המשתמש. עם זאת, חשוב לציין שב-Developer Console אי אפשר לשנות פריטים ב-CourseWork שלא נוצרו באותו מסוף מפתחים. מודל ההרשאות הזה מתאים לשאר מחזור החיים של המטלה, למשל ניהול הגשות וציונים של תלמידים, ולכן לא ניתן לגשת לפריטים האלה ב-CourseWork.
סנכרון מטלות באופן אוטומטי
באמצעות התראות של Pub/Sub, האפליקציה שלכם יכולה להירשם לקבלת התראות שמפעיל אירוע כאשר חלים שינויים בפריטי CourseWork ובהגשות של התלמידים המשויכים אליו. כך האפליקציה יכולה לסנכרן מטלות בקלות, כי אין צורך בבדיקות מתמשכות כדי לראות אם התוכן עודכן ב-Classroom.
השלמה והגשה של מטלות
כל מטלה משויכת ל-N הגשות של תלמידים. N הוא מספר התלמידים שהמטלה הוקצתה להם. כלומר, לכל מטלה יש טופס שהוגש על ידי התלמיד או תלמידה, ואפשר לגשת אליו באמצעות מזהה ייחודי. עבודות התלמידים נוצרות באופן אוטומטי והאפליקציה שלכם יכולה לאחזר אותן יחד עם נקודות הקצה מסוג GET ו-LIST.
אפשר להוסיף קישורים או קבצים להגשה של מטלה ב-CourseWork API, גם בלחצן השיתוף וגם ב-CourseWork API. באמצעות לחצן השיתוף אפשר להשתמש בתהליך עבודה דומה לזה שבתיבת הדו-שיח ליצירת מטלה למורים, וב-CourseWork API דרך נקודת הקצה studentSubmissions.modifyAttachments. עם זאת, בגלל הגבלות ההרשאות ל-API שפירטנו קודם, הפונקציונליות הזו מוגבלת לפריטי CourseWork שהאפליקציה שלכם יצרה. ההגבלה הזו לא חלה על לחצן השיתוף – התלמידים יכולים להוסיף את העבודות שלהם לכל מטלה שהם בוחרים ב-Classroom.
סיום תהליך העבודה של התלמידים
הגבלת ההרשאות ב-CourseWork לא מתאימה לתרחיש לדוגמה של פלטפורמות שלא תומכות ביצירת מטלות, אבל יש יתרון אחד לכך שפלטפורמות של צד שלישי יכולות למנוע מהתלמידים להגיש עבודות באופן שגוי וגם לשכוח להגיש עבודות, כי רק לחצן השיתוף מוגבל על ידי היכולת של התלמידים להגיש מטלות.
בדיקה ומתן ציונים של מטלות
החלק האחרון במחזור החיים של המטלה מוחזר למורה. אחרי שהתלמידים יגישו את המטלה בהצלחה, עכשיו המורה יוכל לבדוק את המטלה בכל דרך שמתאימה לה. אם הקבצים מאוחסנים ב-Drive, הם יכולים לבדוק אותם ישירות בבוחן של Classroom. עם זאת, לא ניתן לגשת לאפליקציות של צד שלישי בכלי לבדיקת ציונים ב-Classroom. כך למשל, המורים צריכים לנווט בין כמה כרטיסיות במהלך הבדיקה ומתן הציונים למטלות.
אי אפשר להשתמש בלחצן השיתוף כדי לתת ציונים או להחזיר מטלות. בשלב זה, תכונות כמו תגובות על הגשה של תלמידים לא מוצגות דרך ה-API, אבל אפשר לתת ציונים וגם להחזיר את הציונים לתלמידים דרך נקודות הקצה studentSubmissions.patch ו-studentSubmissions.return. אפשר לציין ציונים רק לפריטי זרם של CourseWork (מטלות ושאלות). ניתן להשתמש בהם רק במספרים, ואפשר להקצות אותם כטיוטה או כציון סופי.
סיכום ההבדלים
לסיכום של כל מה שנבדק בחלקים הקודמים, בטבלה הבאה מוצגת השוואה בין לחצן השיתוף לבין CourseWork API לארבע הקטגוריות שצוינו למעלה: הטמעה, יצירה ושיתוף של מטלות, השלמה ושליחה של מטלות, ובדיקה ומתן ציון של מטלות.
| לחצן השיתוף | ממשק API ל-CourseWork | |
|---|---|---|
| הטמעה | רק כמה שורות של JavaScript, כדי שההטמעה תהיה פשוטה ומהירה | צריך להגדיר מפתחות API, להפעיל ממשקי API במסוף Admin ומעקב קרוב יותר |
| יצירה ושיתוף של מטלות |
|
|
| השלמה ושליחה של מטלות |
|
|
| בדיקה ומתן ציונים של מטלות | אין תמיכה בציון או בהחזרת ציונים |
|