ציונים

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

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

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

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

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

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

הגשת עבודות באיחור, הגשת עבודות עם אישור והגשת עבודות שלא הוגשו כלל

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

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

המורים יכולים לסמן מטלות שלא הוגשו כהושלמו או כפטרוניות. אם המורה יסמן מטלה כ'הושלמה', השדה draftGrade שמוגדר כברירת מחדל יימחק עד שהמורה יגדיר שדה חדש ידנית.StudentSubmissions מטלות 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 מייצג את הקריטריונים ואת ערכי placeholder שהמורה כתב לפני שהחזיר את המטלה לתלמידים.
• assignedRubricGrades מייצג את הקריטריונים והציונים שהתלמיד/ה יקבל אחרי שהמורה מחזיר/ת את המטלה.

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

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

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