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 נעשה שימוש בתחביר המרת קידוד של gRPC.

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

פרמטרים
courseId

string

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

string

מזהה העבודה בקורס.
id

string

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

גוף הבקשה

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

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

object (Attachment)

קבצים מצורפים להוספה. המטלה יכולה לכלול עד 20 קבצים מצורפים.

Form קבצים מצורפים לא נתמכים.
previewVersion

enum (PreviewVersion)

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

גוף התשובה

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

היקפי ההרשאות

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

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

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