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