ส่วนเสริมของ Google Classroom พร้อมให้บริการแก่นักพัฒนาซอฟต์แวร์แล้ว โปรดดูข้อมูลเพิ่มเติมใน
เอกสารส่วนเสริม
GradingPeriodSettings
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
การตั้งค่าระยะเวลาการให้คะแนนที่มีระยะเวลาการให้คะแนนแต่ละรายการทั้งหมดในหลักสูตร
การแสดง JSON |
{
"gradingPeriods": [
{
object (GradingPeriod )
}
],
"applyToExistingCoursework": boolean,
"previewVersion": enum (PreviewVersion )
} |
ช่อง |
gradingPeriods[] |
object (GradingPeriod )
รายการระยะเวลาการให้คะแนนในหลักสูตรที่เฉพาะเจาะจง ระยะเวลาการให้คะแนนต้องไม่มีช่วงวันที่ทับซ้อนกันและต้องแสดงตามลำดับเวลา ระยะเวลาการให้คะแนนแต่ละระยะเวลาต้องมีชื่อที่ไม่ซ้ำกันภายในหลักสูตร
|
applyToExistingCoursework |
boolean
รองรับการสลับการใช้ระยะเวลาการให้คะแนนกับรายการสตรีมที่มีอยู่ เมื่อตั้งค่าแล้ว ค่านี้จะคงอยู่ ซึ่งหมายความว่าคุณไม่จำเป็นต้องตั้งค่าในคำขอทุกครั้งเพื่ออัปเดต GradingPeriodSettings หากไม่ได้ตั้งค่าไว้ก่อนหน้านี้ ค่าเริ่มต้นจะเป็น "เท็จ"
|
previewVersion |
enum (PreviewVersion )
เอาต์พุตเท่านั้น API เวอร์ชันตัวอย่างที่ใช้ดึงข้อมูลนี้
|
GradingPeriod
ระยะเวลาการให้คะแนนแต่ละระยะเวลา
ระยะเวลาการให้คะแนนต้องไม่มีช่วงวันที่ทับซ้อนกันและต้องแสดงตามลำดับเวลา เช่น หากวันที่สิ้นสุดของระยะเวลาการให้คะแนนคือ 25-01-2024 วันที่เริ่มต้นของระยะเวลาการให้คะแนนถัดไปต้องเป็น 26-01-2024 เป็นต้นไป ระยะเวลาการให้คะแนนแต่ละระยะเวลาต้องมีชื่อที่ไม่ซ้ำกันภายในหลักสูตร
การแสดง JSON |
{
"id": string,
"title": string,
"startDate": {
object (Date )
},
"endDate": {
object (Date )
}
} |
ช่อง |
id |
string
เอาต์พุตเท่านั้น รหัสระยะเวลาการให้คะแนนที่ระบบสร้างขึ้น อ่านอย่างเดียว
|
title |
string
ต้องระบุ ชื่อระยะเวลาการให้คะแนน เช่น "ภาคการศึกษาที่ 1"
|
startDate |
object (Date )
ต้องระบุ วันที่เริ่มต้นของระยะเวลาการให้คะแนนในรูปแบบ UTC ไม่มีการแบ่งแยก
|
endDate |
object (Date )
ต้องระบุ วันที่สิ้นสุดของระยะเวลาการให้คะแนนในรูปแบบ UTC ไม่มีการแบ่งแยก
|
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ 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. |"]]