Method: courses.courseWork.studentSubmissions.patch

עדכון של שדה אחד או יותר בעבודה שהוגשה על ידי תלמיד/ה.

במאמר google.classroom.v1.StudentSubmission מפורט אילו שדות אפשר לעדכן ומי יכול לשנות אותם.

הבקשה הזו צריכה להישלח מהפרויקט ב-Developer Console של מזהה הלקוח ב-OAuth ששימש ליצירת פריט העבודה התואם בקורס.

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

  • PERMISSION_DENIED אם הפרויקט של המפתח המבקש לא יצר את מטלת הקורס המתאימה, אם למשתמש אין הרשאה לבצע את השינוי המבוקש במטלה שהתלמיד שלח או בגלל שגיאות גישה.
  • INVALID_ARGUMENT אם הבקשה לא תקינה.
  • NOT_FOUND אם הקורס, עבודת הקורס או ההגשה של התלמיד/ה המבוקשים לא קיימים.

בקשת HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}

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

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

פרמטרים
courseId

string

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

string

המזהה של העבודה.
id

string

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

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

פרמטרים
updateMask

string (FieldMask format)

מסכה שמזהה אילו שדות יש לעדכן במטלה שהתלמיד/ה שלח/ה. השדה הזה נדרש כדי לבצע עדכון. העדכון נכשל אם צוינו שדות לא חוקיים.

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

  • draftGrade
  • assignedGrade

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

enum (PreviewVersion)

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

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

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

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