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

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

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

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

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