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

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

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

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

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