GradingPeriodSettings
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
הגדרות של תקופות למתן ציונים שכוללות את כל התקופות הנפרדות למתן ציונים בקורס.
| ייצוג ב-JSON |
{
"gradingPeriods": [
{
object (GradingPeriod)
}
],
"applyToExistingCoursework": boolean,
"previewVersion": enum (PreviewVersion)
} |
| שדות |
gradingPeriods[] |
object (GradingPeriod)
רשימת התקופות למתן ציונים בקורס ספציפי. אסור שתהיה חפיפה בין טווחי התאריכים של התקופות למתן ציונים, והן צריכות להופיע בסדר כרונולוגי. לכל תקופה למתן ציונים צריך להיות שם ייחודי בקורס.
|
applyToExistingCoursework |
boolean
תמיכה בהפעלה או השבתה של תקופות למתן ציונים בפריטים קיימים בעדכונים. אחרי שמגדירים את הערך הזה, הוא נשמר, כלומר אין צורך להגדיר אותו בכל בקשה לעדכון של GradingPeriodSettings. אם לא הגדרתם את הערך קודם, ברירת המחדל היא False.
|
previewVersion |
enum (PreviewVersion)
פלט בלבד. גרסת התצוגה המקדימה של ה-API ששימשה לאחזור המשאב הזה.
|
GradingPeriod
תקופה ספציפית למתן ציונים.
אסור שתהיה חפיפה בין טווחי התאריכים של התקופות למתן ציונים, והן צריכות להופיע בסדר כרונולוגי. לדוגמה, אם תאריך הסיום של תקופת הערכה הוא 25 בינואר 2024, תאריך ההתחלה של תקופת הערכה הבאה חייב להיות 26 בינואר 2024 ואילך. לכל תקופה למתן ציונים צריך להיות שם ייחודי בקורס.
| ייצוג ב-JSON |
{
"id": string,
"title": string,
"startDate": {
object (Date)
},
"endDate": {
object (Date)
}
} |
| שדות |
id |
string
פלט בלבד. מזהה תקופת הערכה שנוצר על ידי המערכת. קריאה בלבד.
|
title |
string
חובה. השם של התקופה למתן ציונים. לדוגמה, 'סמסטר 1'.
|
startDate |
object (Date)
חובה. תאריך ההתחלה של תקופת המטלות, לפי שעון UTC. מעודד את קבלת האחר.
|
endDate |
object (Date)
חובה. תאריך הסיום של תקופת המטלות, לפי שעון UTC. מעודד את קבלת האחר.
|
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[],[],null,["# GradingPeriodSettings\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [GradingPeriod](#GradingPeriod)\n - [JSON representation](#GradingPeriod.SCHEMA_REPRESENTATION)\n\nGrading period settings that include all the individual grading periods in a course.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"gradingPeriods\": [ { object (/workspace/classroom/reference/rest/v1/GradingPeriodSettings#GradingPeriod) } ], \"applyToExistingCoursework\": boolean, \"previewVersion\": enum (/workspace/classroom/reference/rest/v1/PreviewVersion) } ``` |\n\n| Fields ||\n|-----------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `gradingPeriods[]` | `object (`[GradingPeriod](/workspace/classroom/reference/rest/v1/GradingPeriodSettings#GradingPeriod)`)` The list of grading periods in a specific course. Grading periods must not have overlapping date ranges and must be listed in chronological order. Each grading period must have a unique title within a course. |\n| `applyToExistingCoursework` | `boolean` Supports toggling the application of grading periods on existing stream items. Once set, this value is persisted meaning that it does not need to be set in every request to update `GradingPeriodSettings`. If not previously set, the default is False. |\n| `previewVersion` | `enum (`[PreviewVersion](/workspace/classroom/reference/rest/v1/PreviewVersion)`)` Output only. The preview version of the API used to retrieve this resource. |\n\nGradingPeriod\n-------------\n\nAn individual grading period.\n\nGrading periods must not have overlapping date ranges and must be listed in chronological order. For example, if the endDate of a grading period is 2024-01-25, then the startDate of the next grading period must be 2024-01-26 or later. Each grading period must have a unique title within a course.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"id\": string, \"title\": string, \"startDate\": { object (/workspace/classroom/reference/rest/v1/Date) }, \"endDate\": { object (/workspace/classroom/reference/rest/v1/Date) } } ``` |\n\n| Fields ||\n|-------------|----------------------------------------------------------------------------------------------------------------------------------|\n| `id` | `string` Output only. System generated grading period ID. Read-only. |\n| `title` | `string` Required. Title of the grading period. For example, \"Semester 1\". |\n| `startDate` | `object (`[Date](/workspace/classroom/reference/rest/v1/Date)`)` Required. Start date, in UTC, of the grading period. Inclusive. |\n| `endDate` | `object (`[Date](/workspace/classroom/reference/rest/v1/Date)`)` Required. End date, in UTC, of the grading period. Inclusive. |"]]
