REST Resource: courses.courseWork

المرجع: CourseWork

عمل الدورة التدريبية الذي أنشأه معلّم لطلاب الدورة التدريبية

تمثيل JSON 
{
  "courseId": string,
  "id": string,
  "title": string,
  "description": string,
  "materials": [
    {
      object (Material)
    }
  ],
  "state": enum (CourseWorkState),
  "alternateLink": string,
  "creationTime": string,
  "updateTime": string,
  "dueDate": {
    object (Date)
  },
  "dueTime": {
    object (TimeOfDay)
  },
  "scheduledTime": string,
  "maxPoints": number,
  "workType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "assigneeMode": enum (AssigneeMode),
  "individualStudentsOptions": {
    object (IndividualStudentsOptions)
  },
  "submissionModificationMode": enum (SubmissionModificationMode),
  "creatorUserId": string,
  "topicId": string,
  "gradeCategory": {
    object (GradeCategory)
  },
  "previewVersion": enum (PreviewVersion),

  // Union field details can be only one of the following:
  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  // End of list of possible types for union field details.
  "gradingPeriodId": string
}
الحقول
courseId

string

معرّف الدورة التدريبية.

للقراءة فقط.
id

string

المعرّف الذي تحدّده "الفصول الدراسية" لهذا العمل الدراسي، وهو فريد لكل دورة دراسية.

للقراءة فقط.
title

string

عنوان عمل الدورة الدراسية هذا. يجب أن يكون العنوان سلسلة UTF-8 صالحة تحتوي على ما بين حرف واحد و3,000 حرف.
description

string

وصف اختياري لمادة الدورة التدريبية هذه في حال ضبطه، يجب أن يكون الوصف سلسلة UTF-8 صالحة لا تحتوي على أكثر من 30,000 حرف.
materials[]

object (Material)

مواد إضافية

يجب ألا يتضمّن "مهام الدورة الدراسية" أكثر من 20 مادة.
state

enum (CourseWorkState)

حالة عمل هذه الدورة التدريبية. إذا لم يتم تحديد حالة، تكون الحالة التلقائية هي DRAFT.
creationTime

string (Timestamp format)

الطابع الزمني لوقت إنشاء عمل الدورة التدريبية هذا

للقراءة فقط.

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
updateTime

string (Timestamp format)

الطابع الزمني لآخر تغيير في عمل الدورة التدريبية هذا.

للقراءة فقط.

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
dueDate

object (Date)

تاريخ اختياري، بالتوقيت العالمي المنسق، لتسليم عمل الدورة التدريبية هذا. يجب تحديد هذا الحقل إذا تم تحديد dueTime.
dueTime

object (TimeOfDay)

وقت اختياري من اليوم بالتوقيت العالمي المتفق عليه لتسليم الواجبات في هذه الدورة الدراسية. يجب تحديد هذا الحقل إذا تم تحديد dueDate.
scheduledTime

string (Timestamp format)

طابع زمني اختياري عند تحديد موعد نشر عمل الدورة التدريبية هذا.

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
maxPoints

number

الحد الأقصى للدرجة التي يمكن الحصول عليها في هذا العمل الدراسي إذا كانت القيمة صفرًا أو غير محدّدة، يتم اعتبار هذه المهمة غير مُقيّمة. يجب أن تكون هذه القيمة عددًا صحيحًا غير سالب.
workType

enum (CourseWorkType)

نوع عمل الدورة الدراسية هذا.

يتم ضبط النوع عند إنشاء عمل الدورة التدريبية ولا يمكن تغييره.
associatedWithDeveloper

boolean

ما إذا كان هذا العنصر من عمل الدورة التدريبية مرتبطًا بمشروع Developer Console الذي يقدّم الطلب.

يُرجى الاطّلاع على courseWork.create لمزيد من التفاصيل.

للقراءة فقط.
assigneeMode

enum (AssigneeMode)

وضع المُسنَد إليه للأعمال الدراسية إذا لم يتم تحديد قيمة، تكون القيمة التلقائية هي ALL_STUDENTS.
individualStudentsOptions

object (IndividualStudentsOptions)

معرّفات الطلاب الذين يمكنهم الوصول إلى الدورات الدراسية لا يتم ضبط هذا الحقل إلا إذا كانت قيمة assigneeMode هي INDIVIDUAL_STUDENTS. إذا كانت قيمة assigneeMode هي INDIVIDUAL_STUDENTS، يتم منح الدورات الدراسية للطلاب المحدّدين في هذا الحقل فقط.
submissionModificationMode

enum (SubmissionModificationMode)

إعداد لتحديد الحالات التي يُسمح فيها للطلاب بتعديل المحتوى الذي أرسلوه إذا لم يتم تحديد قيمة، تكون القيمة التلقائية هي MODIFIABLE_UNTIL_TURNED_IN.
creatorUserId

string

معرّف المستخدم الذي أنشأ المقرر الدراسي.

للقراءة فقط.
topicId

string

معرّف الموضوع المرتبط بعملية التقييم هذه. يجب أن يتطابق مع موضوع حالي في الدورة التدريبية.
gradeCategory

object (GradeCategory)

الفئة التي تساهم فيها درجة هذا العمل الدراسي. لا تظهر هذه العلامة إلا عند اختيار فئة للواجب الدراسي. يمكن استخدامها في احتساب الدرجة الإجمالية.

للقراءة فقط.
previewVersion

enum (PreviewVersion)

النتائج فقط. إصدار المعاينة لواجهة برمجة التطبيقات المستخدَمة لاسترداد هذا المرجع
حقل الربط details تفاصيل إضافية خاصة بنوع من أعمال الدورة الدراسية يمكن أن يكون details واحدًا فقط مما يلي:
assignment

object (Assignment)

تفاصيل المهمة لا تتم تعبئة هذا الحقل إلا عندما يكون workType هو ASSIGNMENT.

للقراءة فقط.
multipleChoiceQuestion

object (MultipleChoiceQuestion)

تفاصيل سؤال الخيارات المتعدّدة بالنسبة إلى عمليات القراءة، لا تتم تعبئة هذا الحقل إلا عندما يكون workType هو MULTIPLE_CHOICE_QUESTION. بالنسبة إلى عمليات الكتابة، يجب تحديد هذا الحقل عند إنشاء عمل دورة تدريبية باستخدام workType‏ MULTIPLE_CHOICE_QUESTION، ويجب عدم ضبطه على أي قيمة أخرى.
gradingPeriodId

string

معرّف فترة التقييم المرتبطة بالمقرر الدراسي

  • في حال عدم تحديده، سيتم ضبط رقم تعريف فترة التقييم استنادًا إلى dueDate (أو scheduledTime في حال عدم ضبط dueDate).
  • للإشارة إلى عدم الارتباط بأيّ فترة وضع درجات، اضبط هذا الحقل على سلسلة فارغة ("").
  • في حال تحديده، يجب أن يتطابق مع معرّف فترة تقييم حالية في الدورة التدريبية.

CourseWorkState

الحالات المحتملة لأعمال الدورة الدراسية

عمليات التعداد
COURSE_WORK_STATE_UNSPECIFIED لم يتم تحديد أيّ ولاية. ولا يتم إرجاع هذا الرمز أبدًا.
PUBLISHED حالة العمل الذي تم نشره هذه هي الحالة التلقائية.
DRAFT حالة العمل الذي لم يتم نشره بعد لا يظهر العمل في هذه الحالة إلا لمعلّمي الدورات الدراسية ومشرفي النطاق.
DELETED حالة العمل الذي تم نشره ولكن تم حذفه الآن لا يظهر العمل في هذه الحالة إلا لمعلّمي الدورات الدراسية ومشرفي النطاق. يتم حذف العمل في هذه الحالة بعد مرور بعض الوقت.

SubmissionModificationMode

أوضاع التعديل الممكنة لعمليات إرسال الطلاب

عمليات التعداد
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED لم يتم تحديد أيّ وضع تعديل. ولا يتم إرجاع هذا الرمز أبدًا.
MODIFIABLE_UNTIL_TURNED_IN يمكن تعديل العينات المرسَلة قبل تسليمها.
MODIFIABLE يمكن تعديل العينات التي تم إرسالها في أي وقت.

Assignment

تفاصيل إضافية للمهام

تمثيل JSON 
{
  "studentWorkFolder": {
    object (DriveFolder)
  }
}
الحقول
studentWorkFolder

object (DriveFolder)

مجلد Drive الذي يتم وضع المرفقات من المحتوى الذي يرسله الطلاب فيه لا يتمّ تعبئة هذا الحقل إلّا للمعلّمين والمشرفين في الدورات التدريبية.

MultipleChoiceQuestion

تفاصيل إضافية للأسئلة ذات الخيارات المتعدّدة

تمثيل JSON 
{
  "choices": [
    string
  ]
}
الحقول
choices[]

string

الخيارات المحتملة

الطُرق

create

 إنشاء عمل الدورة التدريبية

delete

 حذف عمل دورة دراسية

get

 عرض مهام الدورة الدراسية

getAddOnContext

 تحصل هذه الطريقة على البيانات الوصفية لإضافات Classroom في سياق مشاركة معيّنة.

list

 تعرِض هذه السمة قائمة بالأعمال الدراسية التي يُسمح لمقدّم الطلب بعرضها.

modifyAssignees

 تعديل وضع المُسنَد إليه وخيارات مقرر دراسي

patch

 تعديل حقل واحد أو أكثر من عمل الدورة التدريبية