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)
  },

  // 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.
}
الحقول
courseId

string

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

للقراءة فقط:

id

string

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

للقراءة فقط:

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)

تاريخ اختياري، بالتوقيت العالمي المنسّق (UTC)، يجب تسليم المهام المرتبطة بهذه الدورة التدريبية. يجب تحديد هذه القيمة إذا تم تحديد 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

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

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

للقراءة فقط:

حقل الاتحاد details. تفاصيل إضافية خاصة بنوع عمل الدورة الدراسية. يمكن أن تكون السمة "details" واحدة فقط مما يلي:
assignment

object (Assignment)

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

للقراءة فقط:

multipleChoiceQuestion

object (MultipleChoiceQuestion)

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

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

تُحدّث حقلاً واحدًا أو أكثر من عمل الدورة الدراسية.