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