Method: courses.courseWork.studentSubmissions.modifyAttachments

שינוי הקבצים המצורפים של הגשה של תלמיד/ה.

אפשר להוסיף קבצים מצורפים רק למטלות שהתלמידים הגישו, ששייכות לאובייקטים של עבודות בקורס עם הערך workType של ASSIGNMENT.

הבקשה הזו צריכה להישלח מהפרויקט ב-Developer Console של מזהה הלקוח ב-OAuth ששימש ליצירת פריט העבודה התואם בקורס.

השיטה הזו מחזירה את קודי השגיאה הבאים:

  • PERMISSION_DENIED אם למשתמש המבקש אין הרשאה לגשת לקורס או למטלה המבוקשים, אם למשתמש אין הרשאה לשנות את הקבצים המצורפים במטלה של התלמיד/ה המבוקשת, או בגלל שגיאות גישה.
  • INVALID_ARGUMENT אם הבקשה לא תקינה.
  • NOT_FOUND אם הקורס, העבודה או ההגשה של התלמיד/ה המבוקשים לא קיימים.

בקשת HTTP

POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:modifyAttachments

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

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

פרמטרים
courseId

string

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

string

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

string

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

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "addAttachments": [
    {
      object (Attachment)
    }
  ],
  "previewVersion": enum (PreviewVersion)
}
שדות
addAttachments[]

object (Attachment)

קבצים להוספה. אסור לצרף יותר מ-20 קבצים למטלה של תלמיד או תלמידה.

אין תמיכה בקבצים מצורפים מסוג Form.
previewVersion

enum (PreviewVersion)

זה שינוי אופציונלי. גרסת ה-Preview של ה-API. צריך להגדיר את ההגדרה הזו כדי לגשת ליכולות API חדשות שזמינות למפתחים בתוכנית ה-Preview.

גוף התשובה

אם הפעולה מצליחה, גוף התגובה מכיל מופע של StudentSubmission.

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

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

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