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

אם אתם לא מכירים את כלי הקריטריונים להערכה ב-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 מוסבר איך אפשר לקבל חשבון הדגמה לפיתוח.

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