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

המזהה של Announcement, CourseWork או CourseWorkMaterial שאליהם מצורף הקובץ המצורף. השדה הזה הוא חובה, אבל הוא לא מסומן ככזה בזמן שאנחנו מעבירים את הנתונים מה-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

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