ביטול שליחת מטלה של תלמיד/ה בשם התלמיד/ה שבבעלותו/ה המטלה.
כשמחזירים משימת תלמיד/ה, הבעלות על הקבצים המצורפים ב-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 משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
| פרמטרים | |
|---|---|
course |
המזהה של הקורס. המזהה הזה יכול להיות המזהה שהוקצה ב-Classroom או |
course |
המזהה של העבודה. |
id |
המזהה של המטלה שנשלחה על ידי התלמיד/ה. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יהיה ריק.
היקפי הרשאה
נדרש היקף הרשאות OAuth הבא:
https://www.googleapis.com/auth/classroom.coursework.me
מידע נוסף זמין במדריך ההרשאות.