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

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