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

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

للقراءة فقط.

title

string

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

description

string

وصف اختياري لعمل الدورة التدريبية هذا. إذا تم التعيين، يجب أن يكون الوصف سلسلة UTF-8 صالحة لا يزيد طولها عن 30000 حرف.

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

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

حالة الدورة التدريبية

حالات العمل بالطبع المحتملة.

عمليات التعداد
COURSE_WORK_STATE_UNSPECIFIED لم يتم تحديد أية ولاية. ولا يمكن إرجاع هذه القيمة مطلقًا.
PUBLISHED حالة العمل الذي تم نشره. وهذه هي الحالة التلقائية.
DRAFT حالة العمل الذي لم يتم نشره بعد. ويكون العمل في هذه الحالة مرئيًا فقط للمعلمين ومشرفي النطاق.
DELETED حالة العمل الذي تم نشره ولكن تم حذفه الآن. ويكون العمل في هذه الحالة مرئيًا فقط للمعلمين ومشرفي النطاق. يتم حذف العمل في هذه الحالة بعد بعض الوقت.

التاريخ

يمثل تاريخًا كاملاً أو جزئيًا للتقويم، مثل تاريخ الميلاد. ويتم تحديد الوقت من اليوم والمنطقة الزمنية في مكان آخر أو تكون غير مهمة. ويرتبط التاريخ بالتقويم الميلادي. يمكن أن يمثل ذلك واحدًا مما يلي:

  • تاريخ كامل، مع قيم غير صفرية للسنة والشهر واليوم.
  • شهر ويوم، بدون عام (على سبيل المثال، ذكرى سنوية).
  • عام من تلقاء نفسه، ولا يتضمن أي شهر.
  • عام وشهر بدون أي يوم (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة الائتمان).

الأنواع ذات الصلة:

تمثيل JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
الحقول
year

integer

سنة التاريخ يجب أن تتراوح القيمة بين 1 و9999 أو 0 لتحديد تاريخ بدون عام.

month

integer

شهر من السنة. يجب أن تتراوح القيمة بين 1 و12 أو 0 لتحديد سنة بدون شهر ويوم.

day

integer

يوم من الشهر. يجب أن تتراوح القيمة من 1 إلى 31 وتكون صالحة للسنة والشهر، أو 0 لتحديد سنة بمفردها أو السنة والشهر حيث لا يكون اليوم كبيرًا.

الوقت من اليوم

يمثل وقتًا من اليوم. التاريخ والمنطقة الزمنية غير مهمين أو تم تحديدهما في مكان آخر. وقد تختار واجهة برمجة التطبيقات السماح بالثواني الكبيسة. والأنواع ذات الصلة هي google.type.Date وgoogle.protobuf.Timestamp.

تمثيل JSON
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
الحقول
hours

integer

ساعات من اليوم بتنسيق 24 ساعة. يجب أن تتراوح القيمة بين 0 و23. وقد تختار واجهة برمجة التطبيقات السماح بالقيمة "24:00:00" لسيناريوهات مثل وقت إغلاق النشاط التجاري.

minutes

integer

دقائق من الساعة من اليوم. يجب أن تتراوح القيمة بين 0 و59.

seconds

integer

الثواني من الدقائق في الوقت. يجب أن تتراوح في العادة بين 0 و59. وقد تسمح واجهة برمجة التطبيقات بالقيمة 60 إذا كانت تسمح بالثواني الكبيسة.

nanos

integer

كسور من الثواني بالثواني. يجب أن تتراوح القيمة بين 0 و999,999,999.

وضع تعديل الإرسال

أوضاع تعديل محتملة لإرسالات الطلاب.

عمليات التعداد
SUBMISSION_MODIFICATION_MODE_UNSPECIFIED لم يتم تحديد وضع تعديل. ولا يمكن إرجاع هذه القيمة مطلقًا.
MODIFIABLE_UNTIL_TURNED_IN يمكن تعديل الإرسالات قبل تسليمها.
MODIFIABLE يمكن تعديل الإرسالات في أي وقت.

التكليف

تفاصيل إضافية للمهام الدراسية.

تمثيل JSON
{
  "studentWorkFolder": {
    object (DriveFolder)
  }
}
الحقول
studentWorkFolder

object (DriveFolder)

مجلد Drive حيث يتم وضع المرفقات من تسليمات الطلاب. وتتم تعبئة هذا الحقل للمدرسين والمشرفين فقط.

سؤال خيارات متعدّدة

تفاصيل إضافية للأسئلة ذات الخيارات المتعدّدة

تمثيل JSON
{
  "choices": [
    string
  ]
}
الحقول
choices[]

string

الاختيارات المحتملة.

الطُرق

create

ينشئ عمل الدورة التدريبية.

delete

لحذف عمل دورة تدريبية.

get

لعرض أعمال الدورة التدريبية.

list

لعرض قائمة بالدورات التدريبية التي يُسمح لمقدّم الطلب بعرضها

modifyAssignees

لتعديل وضع المُسنَد إليه وخيارات الدورات الدراسية.

patch

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