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 משתמשת בתחביר של Transcoding של gRPC.

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

פרמטרים
courseId

string

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

string

המזהה של העבודה.
id

string

המזהה של המטלה שנשלחה על ידי התלמיד/ה.

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

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

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

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