Method: courses.courseWork.studentSubmissions.reclaim

ביטול שליחת מטלה של תלמיד/ה בשם התלמיד/ה שבבעלותו/ה המטלה.

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

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

פרמטרים
courseId

string

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

string

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

string

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

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

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

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