ציונים

במסמך הזה מוסברים מושגים שקשורים למתן ציונים, שרלוונטיים ל-Classroom API.

במאמר צפייה בציונים ומעקב אחרי מטלות אפשר לקרוא על תהליך מתן הציונים על ידי המורים באפליקציית Google Classroom.

CourseWork and StudentSubmissions

ב-Google Classroom, התלמידים מגישים את המטלות StudentSubmissions של CourseWork בCourse שלהם. אפשר לתת ציון על CourseWork או לא לתת ציון. אם ניתן ציון לCourseWork, יש לו ערך maxPoints שמייצג את מספר הנקודות הכולל שהמטלה שווה. אם הערך של maxPoints הוא אפס או לא צוין, לא ניתן ציון למטלה.

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

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

מטלות באיחור, מטלות עם אישור ומטלות חסרות

כשמטלות CourseWork מוקצות, נוצרים placeholders StudentSubmissions לכל תלמיד, גם אם התלמיד לא ביצע אינטראקציה עם המטלה המתאימה. המורים יכולים להגדיר dueDate בCourseWork, וStudentSubmissions שקשורים אליה מסומנים בשדה late (שמוגדר לערך true) אם התלמיד לא הגיש את המטלה לפני התאריך. מורים יכולים גם להשבית הגשות באיחור באמצעות הגדרה באפליקציית Classroom.

בנוסף, StudentSubmissions שלא מוגשים לפני dueDate מסומנים בגיליון הציונים ב-Classroom כחסרים. מורים יכולים גם לסמן הגשות כ'לא הוגשו' באופן ידני באפליקציית Classroom. מטלות שלא הוגשו מקבלות באופן אוטומטי ציון של draftGrade, שאפשר להתאים אישית, אבל ברירת המחדל היא 0.

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

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

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

ציון כולל ומערכות למתן ציונים

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

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

כמה נקודות חשובות:

• למשאב Course יש אובייקט gradebookSettings עם פרטים על הגדרות הציונים בקורס.
  • ‫calculationType מציין את שיטת החישוב של הקורס.
  • displaySettings מציין מי יכול לראות את הציונים הכוללים באפליקציית Classroom. מומלץ לכבד את ההגדרה הזו באפליקציה שלכם, אם אפשר. לדוגמה, אם התלמידים לא יכולים לראות את הציון הכולל שלהם ב-Classroom, אל תציגו אותו באפליקציה שלכם.
  • ‫gradeCategories מכיל רשימה של קטגוריות הציונים שהוגדרו לקורס, כולל השמות המוצגים שלהן, אחוז המשקל ונקודות ברירת המחדל למטלות התואמות.
• אם בקורס נעשה שימוש בשקלול ציונים, יכול להיות שתצטרכו לנרמל את המשקלים בתרחישים שבהם קטגוריה לא קיימת. לדוגמה, אם המשקלים של קטגוריות הציונים היו 20% לשיעורי בית, 10% לבעיות לתרגול ו-70% לחידונים, אבל בפועל לא היו בעיות לתרגול, מערכת Classroom משנה את המשקלים ל-22% לשיעורי בית ו-78% לחידונים כשמחשבים את הציונים הכוללים. אם אתם מתכוונים לשקף את הציונים הכלליים ב-Classroom באפליקציה שלכם, תצטרכו לעשות את אותו הדבר.

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

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

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

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

• הציון הכולל של כל המטלות בקורס.
• הציון הכולל של כל המטלות בטווח התאריכים של האביב.
• הציון הכולל של כל המטלות בטווח התאריכים של הסמסטר הראשון.

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

בהודעה על תקופות מתן ציונים מופיעה סקירה כללית של התכונה.

התקופות למתן ציונים מורחבות CourseWork עם gradingPeriodId שמזהה את התקופה למתן ציונים שהמטלה משויכת אליה.

במדריך לשימוש ב-API של תקופות מתן ציונים מוסבר איך לקרוא ולנהל תקופות מתן ציונים באמצעות ה-API.

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

מורים יכולים ליצור Rubrics ולשייך אותם למטלות CourseWork, ולהשתמש בהם כהנחיות למתן ציונים למטלות StudentSubmissions.

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

בכלי ההערכה StudentSubmissions יש שדות נוספים:

• ‫rubricId מזהה את קריטריון ההערכה שמתאים לCourseWork של העבודה.
• ‫draftRubricGrades מייצג את הקריטריונים ואת ציוני המיקום שהמורה ניסח לפני החזרת העבודה לתלמיד.
• ‫assignedRubricGrades מייצג את הקריטריונים והציונים שהתלמיד/ה מקבל/ת אחרי שהמורה מחזיר/ה את ההגשה.

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

סולמות ציונים

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