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.

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

פרמטרים
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)

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

גוף הבקשה

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

גוף התשובה

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

היקפי ההרשאות

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

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

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