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

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

للقراءة فقط.

title

string

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

description

string

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

materials[]

object (Material)

مواد إضافية

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

state

enum (CourseWorkState)

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

creationTime

string (Timestamp format)

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

للقراءة فقط.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

الطابع الزمني لأحدث تغيير في هذه الدورة التدريبية.

للقراءة فقط.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

dueDate

object (Date)

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

dueTime

object (TimeOfDay)

الوقت الاختياري من اليوم، بالتوقيت العالمي المنسّق (UTC)، موعد تسليم المهام الدراسية لهذه الدورة التدريبية. يجب تحديد ذلك إذا تم تحديد dueDate.

scheduledTime

string (Timestamp format)

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

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

maxPoints

number

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

workType

enum (CourseWorkType)

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

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

associatedWithDeveloper

boolean

ما إذا كان عنصر عمل الدورة التدريبية هذا مرتبطًا بمشروع Play 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

تُستخدَم لتعديل حقل واحد أو أكثر من مهام الدورة التدريبية.