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

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

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

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

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

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

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