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 כתובה בתחביר של gRPC Transcoding.

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

פרמטרים
courseId

string

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

string

מזהה של עבודת הכיתה.
id

string

מזהה של העבודה שהוגשה על ידי התלמיד או התלמידה.

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

פרמטרים
updateMask

string (FieldMask format)

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

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

  • draftGrade
  • assignedGrade

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

enum (PreviewVersion)

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאות

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

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

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