Google Classroom-Add-ons sind jetzt allgemein für Entwickler verfügbar. Weitere Informationen finden Sie in der
Dokumentation zu Add-ons.
GradingPeriodSettings
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Einstellungen für Benotungszeiträume, die alle einzelnen Benotungszeiträume in einem Kurs umfassen.
| JSON-Darstellung |
{
"gradingPeriods": [
{
object (GradingPeriod)
}
],
"applyToExistingCoursework": boolean,
"previewVersion": enum (PreviewVersion)
} |
| Felder |
gradingPeriods[] |
object (GradingPeriod)
Die Liste der Benotungszeiträume in einem bestimmten Kurs. Die Benotungszeiträume dürfen sich nicht überschneiden und müssen in chronologischer Reihenfolge aufgelistet werden. Jeder Benotungszeitraum muss innerhalb eines Kurses einen eindeutigen Titel haben.
|
applyToExistingCoursework |
boolean
Es ist möglich, die Anwendung von Benotungszeiträumen auf vorhandene Streamelemente zu aktivieren oder zu deaktivieren. Einmal festgelegt, wird dieser Wert beibehalten. Er muss also nicht bei jeder Anfrage zum Aktualisieren von GradingPeriodSettings festgelegt werden. Wenn der Wert nicht festgelegt wurde, ist der Standardwert „False“.
|
previewVersion |
enum (PreviewVersion)
Nur Ausgabe. Die Vorabversion der API, die zum Abrufen dieser Ressource verwendet wurde.
|
GradingPeriod
Ein einzelner Benotungszeitraum.
Die Benotungszeiträume dürfen sich nicht überschneiden und müssen in chronologischer Reihenfolge aufgelistet werden. Wenn das Enddatum eines Benotungszeitraums beispielsweise der 25. 01. 2024 ist, muss das Startdatum des nächsten Benotungszeitraums der 26. 01. 2024 oder später sein. Jeder Benotungszeitraum muss innerhalb eines Kurses einen eindeutigen Titel haben.
| JSON-Darstellung |
{
"id": string,
"title": string,
"startDate": {
object (Date)
},
"endDate": {
object (Date)
}
} |
| Felder |
id |
string
Nur Ausgabe. Vom System generierte Benotungszeitraum-ID. Schreibgeschützt.
|
title |
string
Erforderlich. Titel des Benotungszeitraums. Beispiel: „Semester 1“.
|
startDate |
object (Date)
Erforderlich. Startdatum des Benotungszeitraums in UTC. Inklusiv.
|
endDate |
object (Date)
Erforderlich. Enddatum des Benotungszeitraums in UTC. Inklusiv.
|
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 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. |"]]
