Hiện tại, các nhà phát triển đã có thể sử dụng rộng rãi tiện ích bổ sung của Google Lớp học! Vui lòng xem
tài liệu về tiện ích bổ sung để biết thêm thông tin.
GradingPeriodSettings
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Chế độ cài đặt giai đoạn chấm điểm bao gồm tất cả các giai đoạn chấm điểm riêng lẻ trong một khoá học.
Biểu diễn dưới dạng JSON |
{
"gradingPeriods": [
{
object (GradingPeriod )
}
],
"applyToExistingCoursework": boolean,
"previewVersion": enum (PreviewVersion )
} |
Trường |
gradingPeriods[] |
object (GradingPeriod )
Danh sách các giai đoạn chấm điểm trong một khoá học cụ thể. Các giai đoạn chấm điểm không được có phạm vi ngày chồng chéo nhau và phải được liệt kê theo thứ tự thời gian. Mỗi giai đoạn chấm điểm phải có tiêu đề riêng biệt trong một khoá học.
|
applyToExistingCoursework |
boolean
Hỗ trợ bật/tắt việc áp dụng giai đoạn chấm điểm cho các mục phát trực tiếp hiện có. Sau khi đặt, giá trị này sẽ được duy trì, nghĩa là bạn không cần đặt giá trị này trong mọi yêu cầu cập nhật GradingPeriodSettings . Nếu bạn chưa đặt trước đó, giá trị mặc định sẽ là False.
|
previewVersion |
enum (PreviewVersion )
Chỉ có đầu ra. Phiên bản xem trước của API dùng để truy xuất tài nguyên này.
|
GradingPeriod
Một giai đoạn chấm điểm riêng lẻ.
Các giai đoạn chấm điểm không được có phạm vi ngày chồng chéo nhau và phải được liệt kê theo thứ tự thời gian. Ví dụ: nếu endDate của một kỳ chấm điểm là ngày 25 tháng 1 năm 2024, thì startDate của kỳ chấm điểm tiếp theo phải là ngày 26 tháng 1 năm 2024 trở đi. Mỗi giai đoạn chấm điểm phải có tiêu đề riêng biệt trong một khoá học.
Biểu diễn dưới dạng JSON |
{
"id": string,
"title": string,
"startDate": {
object (Date )
},
"endDate": {
object (Date )
}
} |
Trường |
id |
string
Chỉ có đầu ra. Mã kỳ đánh giá do hệ thống tạo. Chỉ có thể đọc.
|
title |
string
Bắt buộc. Tên của giai đoạn chấm điểm. Ví dụ: "Học kỳ 1".
|
startDate |
object (Date )
Bắt buộc. Ngày bắt đầu của khoảng thời gian chấm điểm, theo giờ UTC. Hoà nhập.
|
endDate |
object (Date )
Bắt buộc. Ngày kết thúc, theo giờ UTC, của khoảng thời gian chấm điểm. Hoà nhập.
|
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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. |"]]