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 صالحة تحتوي على عدد أحرف يتراوح بين 1 و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)

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

اختيارية:

مراجع لأي أهداف تعليمية مرتبطة بهذا الواجب الدراسي يمكن أن يتضمّن CourseWork‏ 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

 تعديل حقل واحد أو أكثر من حقول الواجب الدراسي