Los complementos de Google Classroom ya están en fase de disponibilidad general para desarrolladores. Consulta la
documentación sobre complementos para obtener más información.
GradingPeriodSettings
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Configuración de los períodos de calificación que incluye todos los períodos de calificación individuales de un curso.
Representación JSON |
{
"gradingPeriods": [
{
object (GradingPeriod )
}
],
"applyToExistingCoursework": boolean,
"previewVersion": enum (PreviewVersion )
} |
Campos |
gradingPeriods[] |
object (GradingPeriod )
Es la lista de períodos de calificación de un curso específico. Los períodos de calificación no deben tener períodos superpuestos y deben enumerarse en orden cronológico. Cada período de calificación debe tener un título único dentro de un curso.
|
applyToExistingCoursework |
boolean
Admite activar o desactivar la aplicación de períodos de calificación en los elementos de flujo existentes. Una vez establecido, este valor se conserva, lo que significa que no es necesario establecerlo en cada solicitud para actualizar GradingPeriodSettings . Si no se configuró anteriormente, el valor predeterminado es "False".
|
previewVersion |
enum (PreviewVersion )
Solo salida. Es la versión preliminar de la API que se usa para recuperar este recurso.
|
GradingPeriod
Un período de calificación individual.
Los períodos de calificación no deben tener períodos superpuestos y deben enumerarse en orden cronológico. Por ejemplo, si la fecha de finalización de un período de calificación es el 25/01/2024, la fecha de inicio del siguiente período de calificación debe ser el 26/01/2024 o una fecha posterior. Cada período de calificación debe tener un título único dentro de un curso.
Representación JSON |
{
"id": string,
"title": string,
"startDate": {
object (Date )
},
"endDate": {
object (Date )
}
} |
Campos |
id |
string
Solo salida. Es el ID del período de calificación generado por el sistema. Solo lectura.
|
title |
string
Obligatorio. Es el título del período de calificación. Por ejemplo, “Semestre 1”.
|
startDate |
object (Date )
Obligatorio. Es la fecha de inicio, en UTC, del período de calificación. Inclusivo.
|
endDate |
object (Date )
Obligatorio. Es la fecha de finalización, en UTC, del período de calificación. Inclusivo.
|
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 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. |"]]