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

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

פרמטרים
courseId

string

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

string

מזהה של עבודת הכיתה.
id

string

מזהה של העבודה שהוגשה על ידי התלמיד או התלמידה.

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאות

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

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

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