החזרת מטלה שנשלחה על ידי תלמיד/ה בשם התלמיד/ה שהם הבעלים שלה.
כשמבטלים את ההגשה של תלמיד או תלמידה, הבעלות על הקבצים המצורפים ב-Drive מועברת לתלמיד או לתלמידה, והסטטוס של ההגשה מתעדכן.
רק התלמיד או התלמידה שהגישו את המטלה יכולים להפעיל את השיטה הזו, ורק לגבי מטלה שהוגשה.
הבקשה הזו צריכה להישלח מפרויקט Developer Console של מזהה הלקוח ב-OAuth ששימש ליצירת פריט העבודה התואם בקורס או קובץ מצורף של תוסף בפריט העבודה התואם בקורס.
השיטה הזו מחזירה את קודי השגיאה הבאים:
PERMISSION_DENIEDאם למשתמש ששולח את הבקשה אין הרשאה לגשת לקורס או לעבודה בקורס המבוקשים, לבטל את ההגשה של התלמיד המבוקש או לשגיאות גישה.FAILED_PRECONDITIONאם התלמיד לא הגיש את המטלה.-
INVALID_ARGUMENTאם הבקשה לא תקינה. -
NOT_FOUNDאם הקורס, העבודה או ההגשה של התלמיד/ה לא קיימים.
בקשת HTTP
POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:reclaim
כתובת ה-URL כתובה בתחביר של gRPC Transcoding.
פרמטרים של נתיב
| פרמטרים | |
|---|---|
courseId |
מזהה הקורס. המזהה הזה יכול להיות המזהה שהוקצה ב-Classroom או |
courseWorkId |
מזהה של עבודת הכיתה. |
id |
מזהה של העבודה שהוגשה על ידי התלמיד או התלמידה. |
גוף הבקשה
גוף הבקשה צריך להיות ריק.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה הוא אובייקט JSON ריק.
היקפי הרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/classroom.coursework.me
מידע נוסף זמין במדריך ההרשאות.