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),
  "learningGoals": [
    {
      object (LearningGoal)
    }
  ],

  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  "gradingPeriodId": string
}
الحقول
courseId

string

تمثّل هذه السمة معرّف الدورة التدريبية.

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

string

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

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

string

تمثّل هذه السمة عنوان عمل الدورة التدريبية. يجب أن يكون العنوان سلسلة UTF-8 صالحة تتضمّن ما بين حرف واحد و3000 حرف.
description

string

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

object (Material)

مواد إضافية

يجب ألا تحتوي مهمة CourseWork على أكثر من 20 مادة.
state

enum (CourseWorkState)

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

string (Timestamp format)

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

للقراءة فقط.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

الطابع الزمني لآخر تغيير تم إجراؤه على هذه المهمة الدراسية

للقراءة فقط.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
dueDate

object (Date)

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

object (TimeOfDay)

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

string (Timestamp format)

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

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
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)

النتائج فقط. إصدار المعاينة من واجهة برمجة التطبيقات المستخدَمة لاسترداد هذا المرجع.
learningGoals[]

object (LearningGoal)

اختياريّ.

مراجع لأي أهداف تعليمية مرتبطة بهذا العمل الدراسي لا تتم تعبئة هذا الحقل إلا إذا تم ضبط PreviewVersion المناسب. يمكن أن يتضمّن "العمل الصفي" 10 أهداف تعلُّم كحدّ أقصى.
حقل الربط 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

 تعدّل هذه الطريقة حقلًا واحدًا أو أكثر من حقول الواجب الدراسي.