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

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

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

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

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

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

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

אופן הפעולה של קריטריוני הערכה

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

הקודם
תקופות למתן ציונים