Method: courses.courseWorkMaterials.patch

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

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

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

בקשת HTTP

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

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

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

פרמטרים
courseId

string

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

string

מזהה של חומר לימוד.

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

פרמטרים
updateMask

string (FieldMask format)

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

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

  • title
  • description
  • state
  • scheduledTime
  • topicId

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

enum (PreviewVersion)

אופציונלי. גרסת התצוגה המקדימה של נקודת הקצה.

‫PREVIEW_VERSION_9001 כולל יכולות חדשות: * יש תמיכה בעדכונים של חומרי לימוד. כדי לעדכן חומרי לימוד, משתמשים ב-updateMask ‏materials. רשימת החומרים שמופיעה באובייקט CourseWorkMaterial של הבקשה תחליף באופן מלא את הרשימה הקיימת. אפשר לנקות את השדה materials (חומרים) על ידי ציון הערך materials במסכת העדכון, ולא באובייקט CourseWorkMaterial. בשלב הזה עדכונים של CourseWorkMaterialPUBLISHED לא אפשריים.

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאות

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

  • https://www.googleapis.com/auth/classroom.courseworkmaterials

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