GradingPeriodSettings
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Paramètres des périodes de notation qui incluent toutes les périodes de notation individuelles d'un cours.
Représentation JSON |
{
"gradingPeriods": [
{
object (GradingPeriod )
}
],
"applyToExistingCoursework": boolean,
"previewVersion": enum (PreviewVersion )
} |
Champs |
gradingPeriods[] |
object (GradingPeriod )
Liste des périodes de notation d'un cours spécifique. Les périodes de notation ne doivent pas se chevaucher et doivent être listées dans l'ordre chronologique. Le titre de chaque période de notation doit être unique dans un cours.
|
applyToExistingCoursework |
boolean
Permet d'activer ou de désactiver l'application de périodes de notation aux éléments de flux existants. Une fois définie, cette valeur est conservée, ce qui signifie qu'elle n'a pas besoin d'être définie dans chaque requête pour mettre à jour GradingPeriodSettings . Si ce paramètre n'a pas été défini précédemment, la valeur par défaut est "False".
|
previewVersion |
enum (PreviewVersion )
Uniquement en sortie. Version preview de l'API utilisée pour récupérer cette ressource.
|
GradingPeriod
Période de notation individuelle.
Les périodes de notation ne doivent pas se chevaucher et doivent être listées dans l'ordre chronologique. Par exemple, si la date de fin d'une période de notation est le 25/01/2024, la date de début de la période de notation suivante doit être le 26/01/2024 ou une date ultérieure. Le titre de chaque période de notation doit être unique dans un cours.
Représentation JSON |
{
"id": string,
"title": string,
"startDate": {
object (Date )
},
"endDate": {
object (Date )
}
} |
Champs |
id |
string
Uniquement en sortie. ID de période de notation généré par le système. Lecture seule.
|
title |
string
Obligatoire. Titre de la période de notation. Par exemple, "Semestre 1".
|
startDate |
object (Date )
Obligatoire. Date de début, au format UTC, de la période de notation. Inclusif.
|
endDate |
object (Date )
Obligatoire. Date de fin (UTC) de la période de notation. Inclusif.
|
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 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. |"]]