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)

مواد إضافية.

يجب ألا تحتوي CourseWork على أكثر من 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)

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

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

لمزيد من التفاصيل، يُرجى الانتقال إلى 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

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