Method: courses.courseWork.studentSubmissions.return

מחזירה הגשה של תלמיד.

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

רק מורה בקורס שמכיל את מטלת התלמיד המבוקשת יכול להפעיל את השיטה הזו.

הבקשה הזו צריכה להישלח מפרויקט Developer Console של מזהה הלקוח ב-OAuth ששימש ליצירת פריט העבודה התואם בקורס או קובץ מצורף של תוסף בפריט העבודה התואם בקורס.

השיטה הזו מחזירה את קודי השגיאה הבאים:

  • ‫PERMISSION_DENIED אם למשתמש ששולח את הבקשה אין הרשאה לגשת לקורס או לעבודה בקורס המבוקשים, להחזיר את ההגשה המבוקשת של התלמיד או לשגיאות גישה.
  • ‫INVALID_ARGUMENT אם הבקשה לא תקינה.
  • ‫NOT_FOUND אם הקורס, העבודה או ההגשה של התלמיד/ה לא קיימים.

בקשת HTTP

POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:return

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
courseId

string

מזהה הקורס. המזהה הזה יכול להיות המזהה שהוקצה ב-Classroom או alias.
courseWorkId

string

מזהה של עבודת הכיתה.
id

string

מזהה של העבודה שהוגשה על ידי התלמיד או התלמידה.

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה הוא אובייקט JSON ריק.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/classroom.coursework.students

מידע נוסף זמין במדריך ההרשאות.