تتوفّر الآن إضافات Google Classroom بشكل عام للمطوّرين. يُرجى الاطّلاع على
مستندات الإضافات للحصول على مزيد من المعلومات.
GradingPeriodSettings
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
إعدادات فترات وضع الدرجات التي تتضمّن جميع فترات وضع الدرجات الفردية في دورة تدريبية
تمثيل JSON |
{
"gradingPeriods": [
{
object (GradingPeriod )
}
],
"applyToExistingCoursework": boolean,
"previewVersion": enum (PreviewVersion )
} |
الحقول |
gradingPeriods[] |
object (GradingPeriod )
قائمة فترات وضع الدرجات في دورة تدريبية معيّنة. يجب ألا تتضمّن فترات وضع الدرجات نطاقات زمنية متداخلة، ويجب إدراجها بترتيب زمني. يجب أن يكون لكل فترة وضع درجات عنوان فريد ضمن الدورة التدريبية.
|
applyToExistingCoursework |
boolean
تتيح إمكانية تفعيل أو إيقاف تطبيق فترات وضع الدرجات على عناصر البث الحالية. بعد ضبط هذه القيمة، يتم الاحتفاظ بها، ما يعني أنّه ليس من الضروري ضبطها في كل طلب لتعديل GradingPeriodSettings . إذا لم يتم ضبطها من قبل، تكون القيمة التلقائية False (خطأ).
|
previewVersion |
enum (PreviewVersion )
النتائج فقط. إصدار المعاينة لواجهة برمجة التطبيقات المستخدَمة لاسترداد هذا المرجع
|
GradingPeriod
فترة وضع درجات فردية
يجب ألا تتضمّن فترات وضع الدرجات نطاقات زمنية متداخلة، ويجب إدراجها بترتيب زمني. على سبيل المثال، إذا كان تاريخ انتهاء فترة وضع الدرجات هو 25-01-2024، يجب أن يكون تاريخ بدء الفترة التالية لوضع الدرجات هو 26-01-2024 أو تاريخ لاحق. يجب أن يكون لكل فترة وضع درجات عنوان فريد ضمن الدورة التدريبية.
تمثيل JSON |
{
"id": string,
"title": string,
"startDate": {
object (Date )
},
"endDate": {
object (Date )
}
} |
الحقول |
id |
string
النتائج فقط. رقم تعريف فترة وضع الدرجات الذي أنشأه النظام للقراءة فقط.
|
title |
string
مطلوب. عنوان فترة وضع الدرجات على سبيل المثال، "الفصل الدراسي الأول".
|
startDate |
object (Date )
مطلوب. تاريخ بدء فترة وضع الدرجات بالتوقيت العالمي المنسق شاملة
|
endDate |
object (Date )
مطلوب. تاريخ انتهاء الفترة الزمنية لوضع الدرجات بالتوقيت العالمي المنسق شاملة
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة 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. |"]]