Method: courses.posts.addOnAttachments.studentSubmissions.patch

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

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

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

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

בקשת HTTP

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

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

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

פרמטרים
courseId

string

חובה. המזהה של הקורס.
postId
(deprecated)

string

זה שינוי אופציונלי. האפשרות הזו הוצאה משימוש. במקום זאת, צריך להשתמש ב-itemId.
attachmentId

string

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

string

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

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

פרמטרים
itemId

string

המזהה של Announcement,‏ CourseWork או CourseWorkMaterial שבאמצעותם הקובץ המצורף מצורף. השדה הזה חובה, אבל הוא לא מסומן ככזה בזמן ההעברה מ-postId.
updateMask

string (FieldMask format)

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

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

  • pointsEarned

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

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

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

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