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),
  "learningGoals": [
    {
      object (LearningGoal)
    }
  ],

  "assignment": {
    object (Assignment)
  },
  "multipleChoiceQuestion": {
    object (MultipleChoiceQuestion)
  }
  "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)

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

للقراءة فقط.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 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 في النهاية ويستخدم الأرقام الجزئية 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)

الوقت الاختياري من اليوم، بالتوقيت العالمي المنسق، الذي يحين فيه موعد تسليم هذا العمل الدراسي.

إذا لم يتم تحديد السمة dueTime في الواجب الدراسي الذي يتضمّن السمة dueDate، يتم ضبط السمة dueTime للواجب الدراسي على 23:59 في تاريخ الاستحقاق.
scheduledTime

string (Timestamp format)

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

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 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)

النتائج فقط. الإصدار المبكر الحصري من واجهة برمجة التطبيقات المستخدَم لاسترداد هذا المورد
learningGoals[]

object (LearningGoal)

اختيارية:

مراجع لأي أهداف تعليمية مرفقة بهذا الواجب الدراسي يمكن أن تحتوي المواد التعليمية على 10 أهداف تعلُّم كحدّ أقصى، ولا تتم تعبئة هذا الحقل إلا إذا تم ضبط السمة previewVersion المناسبة.
تفاصيل إضافية خاصة بنوع من الواجب الدراسي في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الردّ:
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

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