Method: courses.courseWork.patch

עדכון של שדה אחד או יותר של מטלה בקורס.

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

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

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

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

בקשת HTTP

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

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

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

פרמטרים
courseId

string

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

string

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

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

פרמטרים
updateMask

string (FieldMask format)

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

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

  • title
  • description
  • state
  • dueDate
  • dueTime
  • maxPoints
  • scheduledTime
  • submissionModificationMode
  • topicId
  • gradingPeriodId זמין מגרסה V1_20240401_PREVIEW ואילך.

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

enum (PreviewVersion)

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

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

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

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