מבנה הקריטריון והגבלות ידועות

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

המבנה של קריטריונים להערכה

יש כמה מושגים חשובים שחשוב להדגיש כשמשתמשים ב-API כדי לבצע פעולות שקשורות לקריטריונים למתן ציונים:

• יש (לכל היותר) קריטריון הערכה אחד שמשויך ל-CourseWork, והקריטריון הזה ייחודי לאותו CourseWork (אי אפשר לשתף אותו עם המשאבים של CourseWork).
• קריטריון ההערכה מורכב מקריטריונים שכוללים רמות. לכל קריטריון להערכה תמיד צריך להיות לפחות קריטריון אחד, ולכל קריטריון תמיד צריכה להיות לפחות רמה אחת.
• אפשר לקבל ניקוד (עם נקודות) או לבטל ניקוד (ללא נקודות). ברמות צריך לתת ציונים באופן מלא או לא לתת ציונים בכלל.
  • אם ניתנים ציונים לרמות, לכל הרמות בקריטריון צריך להיות מוגדר ערך ניקוד ייחודי. נקודות יכולות להיות מספרים שלמים (כמו 10) או ערכים של נקודה צפה (floating-point) (כמו 9.99). הערך יכול להיות 0. לא ניתן להזין ערכים Null. בנוסף, לקריטריון הערכה לא יכול להיות קריטריון יחיד עם רמה אחת שהיא 0 נקודות.
  • אם אין ניקוד לרמות, צריך להשמיט את שדה הנקודות. ערכי null לא יתקבלו.
• הסדר של הקריטריונים והרמות הוא משמעותי ומשקף את הסדר שבו הם מיוצגים בממשק המשתמש של Classroom.
  • במיוחד, רמות עם ניקוד חייבות תמיד להיות ממוינות לפי נקודות בסדר עולה או יורד.
• אפשר להגדיר עד 50 קריטריונים לכל קריטריון הערכה ועד 10 רמות ביצועים לכל קריטריון.

שדות קשורים של הגשות של תלמידים

גם האובייקטים של שליחת תלמידים משתנים:

• בנוסף למאפיינים הקיימים draftGrade ו-assignedGrade, לעבודות שהתלמידים הגישו וקיבלנו עליהן ציונים באמצעות קריטריון הערכה יש את המאפיינים draftRubricGrades ו-assignedRubricGrades. אלה הם הציונים בטבלת הערכה (רמות שנבחרו וערכי הנקודות) שהתלמיד מקבל במהלך מתן הציונים בטבלת הערכה, במצבים 'טיוטה' ו'הוקצה', בהתאמה.
• בשלב זה, הנכסים האלה זמינים לקריאה בלבד. כלומר, אי אפשר להשתמש ב-API כדי לתת ציונים למטלות, אבל אפשר לקרוא מטלות שקיבלתם עליהן ציונים בממשק המשתמש של Classroom.
• הגשות של תלמידים עם קריטריון הערכה משויך מכילות את השדה rubricId. השדה הזה מייצג את מערכת הדירוג האחרונה שמשויכת ל-CourseWork, והערך הזה עשוי להשתנות אם המורים מוחקים מערכת דירוג ויוצרים אותה מחדש.

התנהגויות של קריטריונים להערכה

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

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

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

מגבלות במהלך מתן הציונים

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

• מותר לערוך את הטקסט של השמות והתיאורים של הקריטריונים והרמות.
• סדר הרמות יכול להשתנות בהתאם לקריטריונים.

היקפי גישה נוספים

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

אם יוצרים או מעדכנים קריטריון הערכה מהגיליונות האלה (לדוגמה במדריך), האפליקציה צריכה לבקש את ההיקף https://www.googleapis.com/auth/spreadsheets.readonly או https://www.googleapis.com/auth/spreadsheets. חשוב לזכור שההיקפים spreadsheets נחשבים רגישים, וייתכן שתצטרכו לאמת את האפליקציה.