Method: courses.courseWork.addOnAttachments.studentSubmissions.patch

עדכון נתונים המשויכים לצירוף של תוסף.

צריך להגדיר שהתוסף היה היוצר המקורי של הקובץ המצורף, ולקובץ המצורף יהיה ערך maxPoints חיובי.

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

  • PERMISSION_DENIED עבור שגיאות גישה.
  • INVALID_ARGUMENT אם הבקשה לא תקינה.
  • NOT_FOUND אם אחד מהמשאבים שזוהו לא קיים.

בקשת HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

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

פרמטרים
courseId

string

חובה. מזהה הקורס.
itemId

string

המזהה של ההודעה, הקורס אורך את הקורס 'WorkWorkMaterial' או של הקורס שאליו מצורף הקובץ. חובה למלא את השדה הזה, אבל הוא לא מסומן ככזה בזמן שאנחנו מבצעים העברה מ-postId.
attachmentId

string

חובה. מזהה הקובץ המצורף.
submissionId

string

חובה. מזהה ההגשה של התלמיד/ה.

פרמטרים של שאילתה

פרמטרים
postId
(deprecated)

string

אפשרות. הוצא משימוש. במקומו צריך להשתמש ב-itemId.
updateMask

string (FieldMask format)

חובה. מסכה שמזהה אילו שדות בקובץ המצורף יש לעדכן. העדכון ייכשל אם יצוינו שדות לא חוקיים. אם שדה תומך בערכים ריקים, ניתן לנקות אותו על ידי ציון שלו במסכת העדכון ולא באובייקט AddOnAttachmentStudentSubmission.

המורים רשאים לציין את השדות הבאים:

  • pointsEarned

זוהי רשימה של שמות שדות מלאים, שמופרדים בפסיקים. דוגמה: "user.displayName,photo"

גוף הבקשה

גוף הבקשה מכיל מופע של AddOnAttachmentStudentSubmission.

גוף התגובה

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

היקפי הרשאות

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

  • https://www.googleapis.com/auth/classroom.addons.teacher

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