Dodatki do Google Classroom są teraz ogólnie dostępne dla programistów. Więcej informacji znajdziesz w
dokumentacji dodatków.
GradingPeriodSettings
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Ustawienia okresu oceniania, które obejmują wszystkie okresy oceniania w kursie.
Zapis JSON |
{
"gradingPeriods": [
{
object (GradingPeriod )
}
],
"applyToExistingCoursework": boolean,
"previewVersion": enum (PreviewVersion )
} |
Pola |
gradingPeriods[] |
object (GradingPeriod )
Lista okresów oceniania w danym kursie. Okresy oceniania nie mogą mieć nakładających się zakresów dat i muszą być wymienione w porządku chronologicznym. Każdy okres oceniania musi mieć unikalny tytuł w ramach kursu.
|
applyToExistingCoursework |
boolean
Obsługuje przełączanie stosowania okresów oceniania w przypadku istniejących elementów strumienia. Po ustawieniu ta wartość jest zapisywana, co oznacza, że nie musisz jej ustawiać w każdej prośbie o aktualizację GradingPeriodSettings . Jeśli nie zostało wcześniej ustawione, domyślnie jest ustawione na False.
|
previewVersion |
enum (PreviewVersion )
Tylko dane wyjściowe. Wersja podglądu interfejsu API używana do pobierania tego zasobu.
|
GradingPeriod
Pojedynczy okres oceniania.
Okresy oceniania nie mogą mieć nakładających się zakresów dat i muszą być wymienione w porządku chronologicznym. Jeśli na przykład data zakończenia okresu oceniania to 2024-01-25, data rozpoczęcia następnego okresu oceniania musi być równa 2024-01-26 lub późniejsza. Każdy okres oceniania musi mieć unikalny tytuł w ramach kursu.
Zapis JSON |
{
"id": string,
"title": string,
"startDate": {
object (Date )
},
"endDate": {
object (Date )
}
} |
Pola |
id |
string
Tylko dane wyjściowe. Identyfikator okresu oceniania wygenerowany przez system. Tylko do odczytu.
|
title |
string
Wymagane. Nazwa okresu oceniania. Na przykład „Semester 1”.
|
startDate |
object (Date )
Wymagane. Data rozpoczęcia okresu oceniania w strefie czasowej UTC. Integracja społeczna.
|
endDate |
object (Date )
Wymagane. Data zakończenia okresu oceniania w strefie czasowej UTC. Integracja społeczna.
|
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[null,null,["Ostatnia aktualizacja: 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. |"]]