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

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