Method: courses.courseWork.studentSubmissions.modifyAttachments

עריכת הקבצים המצורפים של התלמיד או התלמידה.

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

את הבקשה הזו יש לשלוח באמצעות הפרויקט ב-Play 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

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