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

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

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

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

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