Method: courses.courseWorkMaterials.patch

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

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

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

בקשת HTTP

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

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

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

פרמטרים
courseId

string

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

string

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

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

פרמטרים
updateMask

string (FieldMask format)

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

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

  • title
  • description
  • state
  • scheduledTime
  • topicId

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

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

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

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