Method: courses.courseWork.studentSubmissions.turnIn

הגשת מטלה על ידי תלמיד/ה.

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

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

פרמטרים
courseId

string

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

courseWorkId

string

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

id

string

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

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

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

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