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 תוחלף באופן מלא בתקופות מתן הציונים שצוינו בבקשת העדכון. לדוגמה:
- תקופות למתן ציונים שכלולות ברשימה ללא מזהה נחשבות כתוספות, ויוקצה להן מזהה חדש כשהבקשה תישלח.
- תקופות למתן ציונים שקיימות כרגע אבל לא נכללות בבקשה ייחשבו כמחיקות.
- תקופות למתן ציונים עם מזהה קיים ונתונים ששונו נחשבות לעריכות. נתונים שלא שונו יישארו כפי שהם.
- אם תקופות למתן ציונים ייכללו במזהה לא ידוע, תופיע שגיאה.
אפשר לציין את השדות הבאים:
gradingPeriodsapplyToExistingCoursework זוהי רשימה של שמות שדות מוגדרים במלואם, שמופרדים בפסיקים. דוגמה: "user.displayName,photo"
|
previewVersion |
enum (PreviewVersion)
זה שינוי אופציונלי. גרסת ה-Preview של ה-API. צריך להגדיר את ההגדרה הזו כדי לגשת ליכולות API חדשות שזמינות למפתחים בתוכנית ה-Preview.
|
גוף הבקשה
גוף הבקשה מכיל מופע של GradingPeriodSettings.
גוף התשובה
אם הפעולה מצליחה, גוף התגובה מכיל מופע של GradingPeriodSettings.
היקפי הרשאה
נדרש היקף הרשאות OAuth הבא:
https://www.googleapis.com/auth/classroom.courses
מידע נוסף זמין במדריך ההרשאות.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-12-05 (שעון UTC).
[null,null,["עדכון אחרון: 2024-12-05 (שעון 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."]]],[]]
