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

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

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

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

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

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

אובייקטים מסוג StudentSubmission תומכים בשדות שקשורים לקריטריונים להערכה:

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

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

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

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

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

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

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

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

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

אפשר לייצא באופן ידני קריטריונים למתן ציונים לגיליון אלקטרוני ב-Google Sheets כדי שהמורים יוכלו להשתמש בהם שוב.

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

עבודות של צד שלישי

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

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

דרישות לגבי רישיונות

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

• למשתמש ששולח את הבקשה הוקצה רישיון Google Workspace for Education Plus.
• לבעלים של הקורס הרלוונטי הוקצה רישיון Google Workspace for Education Plus.

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