افزونه های Google Classroom اکنون به طور کلی در دسترس توسعه دهندگان هستند! لطفاً برای اطلاعات بیشتر به
اسناد افزونه ها مراجعه کنید.
GradingPeriodSettings
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
تنظیمات دوره درجه بندی که شامل تمام دوره های نمره دهی فردی در یک دوره می شود.
| نمایندگی JSON |
|---|
{
"gradingPeriods": [
{
object (GradingPeriod)
}
],
"applyToExistingCoursework": boolean,
"previewVersion": enum (PreviewVersion)
} |
| فیلدها |
|---|
gradingPeriods[] | object ( GradingPeriod ) لیست دوره های نمره دهی در یک دوره خاص. دوره‌های درجه‌بندی نباید دارای بازه‌های تاریخ همپوشانی باشند و باید به ترتیب زمانی فهرست شوند. هر دوره نمره دهی باید یک عنوان منحصر به فرد در یک دوره داشته باشد. |
applyToExistingCoursework | boolean از تغییر کاربرد دوره‌های درجه‌بندی در آیتم‌های جریان موجود پشتیبانی می‌کند. پس از تنظیم، این مقدار باقی می ماند به این معنی که لازم نیست در هر درخواست برای به روز رسانی GradingPeriodSettings تنظیم شود. اگر قبلا تنظیم نشده باشد، پیش فرض نادرست است. |
previewVersion | enum ( PreviewVersion ) فقط خروجی نسخه پیش نمایش API مورد استفاده برای بازیابی این منبع. |
دوره درجه بندی
دوره نمره دهی فردی
دوره های درجه بندی نباید دارای بازه های تاریخ همپوشانی باشند و باید به ترتیب زمانی فهرست شوند. به عنوان مثال، اگر تاریخ پایان یک دوره درجه بندی 2024-01-25 باشد، تاریخ شروع دوره درجه بندی بعدی باید 2024-01-26 یا بالاتر باشد. هر دوره نمره دهی باید یک عنوان منحصر به فرد در یک دوره داشته باشد.
| نمایندگی JSON |
|---|
{
"id": string,
"title": string,
"startDate": {
object (Date)
},
"endDate": {
object (Date)
}
} |
| فیلدها |
|---|
id | string فقط خروجی شناسه دوره درجه بندی ایجاد شده توسط سیستم. فقط خواندنی |
title | string مورد نیاز. عنوان دوره درجه بندی. به عنوان مثال، "ترم 1". |
startDate | object ( Date ) مورد نیاز. تاریخ شروع دوره درجه بندی، به UTC. فراگیر. |
endDate | object ( Date ) مورد نیاز. تاریخ پایان دوره درجه بندی، به UTC. فراگیر. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[],[],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. |"]]
