이제 Google 클래스룸 부가기능이 일반적으로 개발자에게 제공됩니다. 자세한 내용은
부가기능 문서를 참고하세요.
GradingPeriodSettings
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
과정의 모든 개별 평가 기간을 포함하는 평가 기간 설정입니다.
JSON 표현 |
{
"gradingPeriods": [
{
object (GradingPeriod )
}
],
"applyToExistingCoursework": boolean,
"previewVersion": enum (PreviewVersion )
} |
필드 |
gradingPeriods[] |
object (GradingPeriod )
특정 과정의 평가 기간 목록입니다. 평가 기간의 기간이 겹치면 안 되며 연대순으로 나열해야 합니다. 각 평가 기간의 제목은 과정 내에서 고유해야 합니다.
|
applyToExistingCoursework |
boolean
기존 스트림 항목에서 평가 기간 적용을 전환할 수 있습니다. 이 값은 설정되면 유지되므로 GradingPeriodSettings 를 업데이트하기 위한 모든 요청에서 설정할 필요가 없습니다. 이전에 설정하지 않은 경우 기본값은 False입니다.
|
previewVersion |
enum (PreviewVersion )
출력 전용입니다. 이 리소스를 검색하는 데 사용되는 API의 미리보기 버전입니다.
|
GradingPeriod
개별 평가 기간입니다.
평가 기간의 기간이 겹치면 안 되며 연대순으로 나열해야 합니다. 예를 들어 평가 기간의 endDate가 2024-01-25인 경우 다음 평가 기간의 startDate는 2024-01-26 이후여야 합니다. 각 평가 기간의 제목은 과정 내에서 고유해야 합니다.
JSON 표현 |
{
"id": string,
"title": string,
"startDate": {
object (Date )
},
"endDate": {
object (Date )
}
} |
필드 |
id |
string
출력 전용입니다. 시스템에서 생성한 평가 기간 ID입니다. 읽기 전용입니다.
|
title |
string
필수 항목입니다. 평가 기간의 제목입니다. 예: '1학기'
|
startDate |
object (Date )
필수 항목입니다. 평가 기간의 시작일(UTC)입니다. 포용적이고
|
endDate |
object (Date )
필수 항목입니다. 평가 기간의 종료일(UTC)입니다. 포용적이고
|
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 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. |"]]