Method: courses.courseWork.studentSubmissions.patch

• בקשת HTTP
• פרמטרים של נתיב
• פרמטרים של שאילתות
• גוף הבקשה
• גוף התשובה
• היקפי הרשאה
• רוצים לנסות?

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

במאמר 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

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