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 תוחלף במלואה בתקופות למתן ציונים שצוינו בבקשת העדכון. לדוגמה:
- תקופות למתן ציונים שכלולות ברשימה ללא מזהה נחשבות לתוספות, והמערכת תקצה מזהה חדש כשתוגש הבקשה.
- תקופות למתן ציונים הקיימות כרגע, אבל חסרות בבקשה, ייחשבו כמחיקות.
- תקופות למתן ציונים עם מזהה קיים ונתונים ששונו נחשבות כעריכות. נתונים שלא בוצעו יישארו כפי שהם.
- תקופות למתן ציונים שכלולות במזהה לא ידוע יגרמו לשגיאה.
אפשר לציין את השדות הבאים:
gradingPeriodsapplyToExistingCoursework זוהי רשימה מופרדת בפסיקים של שמות שדות מלאים. דוגמה: "user.displayName,photo"
|
previewVersion |
enum (PreviewVersion)
זה שינוי אופציונלי. גרסת התצוגה המקדימה של ה-API. צריך להגדיר את האפשרות הזו כדי לקבל גישה ליכולות חדשות של API שזמינות למפתחים בתוכנית התצוגה המקדימה.
|
גוף הבקשה
גוף הבקשה מכיל מופע של GradingPeriodSettings.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע של GradingPeriodSettings.
היקפי ההרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/classroom.courses
מידע נוסף זמין במדריך להרשאות.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-02-27 (שעון UTC).
[null,null,["עדכון אחרון: 2025-02-27 (שעון UTC)."],[[["Updates a course's grading period settings, requiring eligibility to modify them by both the requesting user and course owner."],["The request must include a field mask to specify which fields of the GradingPeriodSettings are to be updated, potentially adding, deleting, or editing grading periods."],["The API uses a PATCH request to `https://classroom.googleapis.com/v1/courses/{courseId}/gradingPeriodSettings`, where `{courseId}` is replaced with the specific course identifier."],["Potential errors include `PERMISSION_DENIED`, `INVALID_ARGUMENT`, and `NOT_FOUND` based on user permissions, request validity, and course existence."],["Authorization requires the `https://www.googleapis.com/auth/classroom.courses` OAuth scope."]]],[]]
