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 صالحة تتضمّن ما بين حرف واحد و3000 حرف.
description

string

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

object (Material)

مواد إضافية

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

enum (CourseWorkState)

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

string (Timestamp format)

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

للقراءة فقط.

يستخدم هذا النوع RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا Z-normalized ويستخدم 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-normalized ويستخدم 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-normalized ويستخدم 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)

النتائج فقط. تمثّل هذه السمة الإصدار التجريبي من واجهة برمجة التطبيقات المستخدَمة لاسترداد هذا المورد.
حقل الدمج 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

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