Method: courses.updateGradingPeriodSettings

לעדכן את ההגדרות של התקופות למתן ציונים בקורס.

למשתמש ששלח את הבקשה ולבעלים של הקורס צריך להיות רישיון נתמך. מידע נוסף על דרישות הרישוי

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

  • PERMISSION_DENIED אם המשתמש ששלח את הבקשה לא רשאי לשנות את הגדרות התקופה למתן ציונים בקורס או אם יש שגיאות גישה:
    • UserIneligibleToUpdateGradingPeriodSettings
  • INVALID_ARGUMENT אם הבקשה בפורמט שגוי.
  • NOT_FOUND אם הקורס המבוקש לא קיים.

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

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

פרמטרים
courseId

string

חובה. מזהה הקורס.

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

פרמטרים
updateMask

string (FieldMask format)

מסכה שמציינת אילו שדות ב-GradingPeriodSettings צריך לעדכן.

הרשימה GradingPeriodSettings gradingPeriods תוחלף במלואה בתקופות למתן ציונים שצוינו בבקשת העדכון. למשל:

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

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

  • gradingPeriods
  • applyToExistingCoursework

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

enum (PreviewVersion)

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

גוף הבקשה

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

גוף התשובה

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

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

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

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

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