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

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

פרמטרים
courseId

string

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

string

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

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

פרמטרים
updateMask

string (FieldMask format)

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

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

  • title
  • description
  • state
  • dueDate
  • dueTime
  • maxPoints
  • scheduledTime
  • submissionModificationMode
  • topicId
  • gradingPeriodId
  • learningGoals

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

enum (PreviewVersion)

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאות

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

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

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