Method: courses.updateGradingPeriodSettings

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

אפשר להוסיף, להסיר או לשנות תקופות למתן ציונים בנפרד באמצעות השיטה הזו.

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

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

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

בקשת HTTP

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

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

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

פרמטרים
courseId

string

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

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

פרמטרים
updateMask

string (FieldMask format)

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

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

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

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

  • gradingPeriods
  • applyToExistingCoursework

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

enum (PreviewVersion)

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

גוף הבקשה

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

גוף התשובה

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

היקפי הרשאה

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

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

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