במדריך הזה מתוארות דוגמאות לקודים שקשורים לציונים ב-Google Classroom API. כדאי לקרוא את המדריך לציונים כדי להכיר את המושגים בנושא מתן ציונים ב-Classroom.
הגדרת ציונים לגבי הגשות של תלמידים
למשאב StudentSubmission יש שני שדות לאחסון ציונים: assignedGrade, שהוא הציון שמדווח לתלמידים, ו-draftGrade, שהוא ציון זמני שגלוי רק למורים. השדות האלה מתעדכנים באמצעות courses.courseWork.studentSubmissions.patch.
Python
studentSubmission = {
'assignedGrade': 99,
'draftGrade': 80
}
service.courses().courseWork().studentSubmissions().patch(
courseId=course_id,
courseWorkId=coursework_id,
id=studentsubmission_id,
updateMask='assignedGrade,draftGrade',
body=studentSubmission).execute()
Java
כשעובדים בממשק המשתמש של Classroom, המורים לא יכולים להקצות ציון עד שהם שומרים טיוטה של ציון. לאחר מכן תוכלו להחזיר את הציון לתלמידים. האפליקציה שלכם יכולה לתת ציון למטלה של תלמיד או תלמידה באחת משתי דרכים:
מקצים רק את
draftGrade. למשל, אפשר להשתמש באפשרות הזו כדי לאפשר למורים לבדוק את הציונים באופן ידני לפני שהם מאשרים אותם. התלמידים לא יכולים לראות טיוטות של ציונים.כדי לתת ציון מלא על מטלה, צריך להקצות גם את
draftGradeוגם אתassignedGrade.
קריאת הציונים שהוקצו
כדי לקבל רשימה של כל הציונים של פריט עבודה מסוים, אפשר לבדוק את אובייקט התגובה של השיטה courses.courseWork.studentSubmissions.list:
Python
response = coursework.studentSubmissions().list(
courseId=course_id,
courseWorkId=coursework_id,
pageSize=10 # optionally include `pageSize` to restrict the number of student submissions included in the response.
).execute()
submissions.extend(response.get('studentSubmissions', []))
if not submissions:
print('No student submissions found.')
print('Student Submissions:')
for submission in submissions:
print(f"Submitted at:"
f"{(submission.get('userId'), submission.get('assignedGrade'))}")
Java
חישוב ציונים כוללים בקורס
Classroom API לא מאפשר למפתחים לקרוא או לכתוב את הציון הכולל של הקורס, אבל אפשר לחשב אותו באופן פרוגרמטי. במאמר על הגדרת ציונים במרכז העזרה תוכלו למצוא טיפים לחישוב הזה. המשאב Course כולל את השדה gradebookSettings שיכול לעזור לבצע את החישובים.
אם אתם רוצים לחשב את הציון הכולל, כדאי לקרוא את הטיפים הבאים כדי להבין איך מנהלים עבודות שהוגשו באיחור, עבודות שהוגשו עם אישור ועבודות שלא הוגשו.
ניהול מצב התשובות של התלמידים
אפשר לבטל את ההגשה של תשובה של תלמיד/ה, להגיש אותה או להחזיר אותה. השדה state ב-StudentSubmission מציין את המצב הנוכחי. כדי לשנות את המצב, מפעילים את אחת מהשיטות הבאות:
courses.courseWork.studentSubmissions.turnIn: רק התלמיד שבבעלותוStudentSubmissionיכול להגיש את המטלה.courses.courseWork.studentSubmissions.reclaim: רק התלמיד שבבעלותוStudentSubmissionיכול לשחזר את הבעלות. אפשר לבטל את ההגשה רק אם היא כבר נשלחה.courses.courseWork.studentSubmissions.return: רק מורים בקורס יכולים להחזירStudentSubmission. אפשר להחזיר את המטלה רק אם התלמיד כבר הגיש אותה.
בכל השיטות האלה מקבלים פרמטר body ריק, לדוגמה:
Python
service.courses().courseWork().studentSubmission().turnIn(
courseId=course_id,
courseWorkId=coursework_id,
id=studentsubmission_id,
body={}).execute()
Java
ציון קבצים מצורפים של תוספים
מפתחים של תוספים ל-Classroom יכולים להגדיר ציונים לקובצי מצורף ספציפיים בתוספים, ולהגדיר שהציון יהיה גלוי למורים כשהם בודקים את העבודות של התלמידים. למידע נוסף, אפשר לעיין במדריכים בנושא קבצים מצורפים מסוג 'פעילות' והעברת ציונים.