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

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

פרמטרים
courseId

string

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

string

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

string

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאות

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

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

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