REST Resource: courses.courseWork.studentSubmissions

المورد: StudentSubmission

إرسال الطلاب للمهام الدراسية

يتم إنشاء StudentSubmission عنصر عند إنشاء عنصر CourseWork.

قد لا تتضمّن عمليات إرسال الطلاب التي لم يتم الوصول إليها مطلقًا (أي التي تحمل القيمة state = NEW) وقت الإنشاء أو وقت التعديل.

تمثيل JSON 
{
  "courseId": string,
  "courseWorkId": string,
  "id": string,
  "userId": string,
  "creationTime": string,
  "updateTime": string,
  "state": enum (SubmissionState),
  "late": boolean,
  "draftGrade": number,
  "assignedGrade": number,
  "rubricId": string,
  "draftRubricGrades": {
    string: {
      object (RubricGrade)
    },
    ...
  },
  "assignedRubricGrades": {
    string: {
      object (RubricGrade)
    },
    ...
  },
  "alternateLink": string,
  "courseWorkType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "submissionHistory": [
    {
      object (SubmissionHistory)
    }
  ],
  "previewVersion": enum (PreviewVersion),

  // Union field content can be only one of the following:
  "assignmentSubmission": {
    object (AssignmentSubmission)
  },
  "shortAnswerSubmission": {
    object (ShortAnswerSubmission)
  },
  "multipleChoiceSubmission": {
    object (MultipleChoiceSubmission)
  }
  // End of list of possible types for union field content.
}
الحقول
courseId

string

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

للقراءة فقط.
courseWorkId

string

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

للقراءة فقط.
id

string

المعرّف الذي يحدّده Classroom لعمل الطالب الذي تم إرساله. هذا المعرّف فريد بين عمليات الإرسال الخاصة بالعمل ذي الصلة في الدورة التدريبية.

للقراءة فقط.
userId

string

معرّف الطالب الذي يملك عملية الإرسال هذه.

للقراءة فقط.
creationTime

string (Timestamp format)

وقت إنشاء هذا الطلب. قد لا يتم ضبط هذه القيمة إذا لم يصل الطالب إلى هذا العنصر.

للقراءة فقط.

يستخدم هذا النوع RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا Z-normalized ويستخدم 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-normalized ويستخدم 0 أو 3 أو 6 أو 9 أرقام كسرية. يتم أيضًا قبول الإزاحات غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
state

enum (SubmissionState)

حالة عملية الإرسال هذه.

للقراءة فقط.
late

boolean

تُستخدَم لتحديد ما إذا كان العمل الذي تم إرساله متأخّرًا.

للقراءة فقط.
draftGrade

number

الدرجة المعلّقة الاختيارية في حال عدم ضبطها، لم يتم ضبط أي درجة. يجب أن تكون هذه القيمة غير سالبة. يُسمح باستخدام القيم العشرية (أي غير الصحيحة)، ولكن يتم تقريبها إلى منزلتَين عشريتَين.

يمكن للمعلّمين في الدورة التدريبية فقط الاطّلاع على هذه المعلومات وتعديلها.
assignedGrade

number

درجة اختيارية في حال عدم ضبطها، لم يتم ضبط أي درجة. يجب أن تكون هذه القيمة غير سالبة. يُسمح باستخدام القيم العشرية (أي غير الصحيحة)، ولكن يتم تقريبها إلى منزلتَين عشريتَين.

يمكن للمعلّمين في الدورة التدريبية فقط تعديل هذا الإعداد.
rubricId

string

النتائج فقط. معرّف لقاعدة التقييم المرفقة حاليًا بهذا الواجب الدراسي والمستخدَمة لتقييم هذا العمل الذي أرسله الطالب.

يكون هذا المعرّف فارغًا إذا لم تكن هناك قاعدة تقييم. يعرض هذا المعرّف نموذج التقييم النشط حاليًا، ويتغيّر إذا حذف المعلّمون نموذج التقييم وأعادوا إنشاءه.

للقراءة فقط.

draftRubricGrades

map (key: string, value: object (RubricGrade))

درجات قواعد التقييم المعلّقة استنادًا إلى معايير قواعد التقييم

تكون هذه الخريطة فارغة إذا لم يتم إرفاق نموذج تقييم بهذا العمل الدراسي أو إذا تم إرفاق نموذج تقييم ولكن لم يتم ضبط أي درجات على أي معايير. لا تتم تعبئة الإدخالات إلا للدرجات التي تم ضبطها. المفتاح: رقم تعريف معيار التقييم.

للقراءة فقط.

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }
assignedRubricGrades

map (key: string, value: object (RubricGrade))

درجات قواعد التقييم التي تم تعيينها استنادًا إلى معايير قواعد التقييم

تكون هذه الخريطة فارغة إذا لم يتم إرفاق نموذج تقييم بعمل الدورة التدريبية هذا أو إذا تم إرفاق نموذج تقييم ولكن لم يتم ضبط أي درجات على أي معايير. لا تتم تعبئة الإدخالات إلا للدرجات التي تم ضبطها. المفتاح: رقم تعريف معيار التقييم.

للقراءة فقط.

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }
courseWorkType

enum (CourseWorkType)

تمثّل هذه السمة نوع عمل الدورة التدريبية الذي تم إرسال هذا المحتوى إليه.

للقراءة فقط.
associatedWithDeveloper

boolean

تُستخدَم لتحديد ما إذا كان نموذج إرسال الطالب هذا مرتبطًا بمشروع Developer Console الذي يقدّم الطلب.

يمكنك الاطّلاع على courseWork.create لمزيد من التفاصيل.

للقراءة فقط.
submissionHistory[]

object (SubmissionHistory)

سجلّ عملية الإرسال (يشمل سجلّات الحالة والدرجة)

للقراءة فقط.
previewVersion

enum (PreviewVersion)

النتائج فقط. إصدار المعاينة من واجهة برمجة التطبيقات يجب ضبط هذا الإعداد للوصول إلى إمكانات واجهة برمجة التطبيقات الجديدة التي أتحناها للمطوّرين في "برنامج الإصدار التجريبي".
حقل الدمج content محتوى الطلب يعتمد النوع المحدّد على قيمة course_work_type. يمكن أن تكون content إحدى القيم التالية فقط:
assignmentSubmission

object (AssignmentSubmission)

محتوى المهمة المُرسَلة عندما تكون قيمة courseWorkType هي ASSIGNMENT

يمكن للطلاب تعديل هذا المحتوى باستخدام studentSubmissions.modifyAttachments.
shortAnswerSubmission

object (ShortAnswerSubmission)

محتوى نموذج الإرسال عندما يكون courseWorkType هو SHORT_ANSWER_QUESTION
multipleChoiceSubmission

object (MultipleChoiceSubmission)

محتوى نموذج الإجابة عند ضبط courseWorkType على MULTIPLE_CHOICE_QUESTION

RubricGrade

درجة التقييم المحدّدة لمَهمّة الطالب يمكن إدخال درجة واحدة على الأكثر لكل معيار من معايير قواعد التقييم.

تمثيل JSON 
{
  "criterionId": string,
  "levelId": string,
  "points": number
}
الحقول
criterionId

string

اختياريّ. معرّف المعيار
levelId

string

اختياريّ. المعرّف الاختياري للمستوى المحدّد. إذا كان فارغًا، لم يتم اختيار أي مستوى.
points

number

اختياريّ. النقاط الاختيارية المخصّصة لهذا المعيار، والتي تستند عادةً إلى المستوى قد تتضمّن المستويات نقاطًا أو لا تتضمّنها. في حال عدم ضبطها، لم يتم ضبط أي نقاط لهذا المعيار.

AssignmentSubmission

عمل الطالب في إحدى المهام

تمثيل JSON 
{
  "attachments": [
    {
      object (Attachment)
    }
  ]
}
الحقول
attachments[]

object (Attachment)

المرفقات التي أضافها الطالب قد لا تكون ملفات Drive التي تتوافق مع المواد التي تم ضبط وضع مشاركتها على STUDENT_COPY متوفّرة بعد إذا لم يصل الطالب إلى المهمة في Classroom.

لا تتم تعبئة بعض بيانات وصفية للمرفقات إلا إذا كان لدى المستخدم الذي يطلبها إذن بالوصول إليها. تتوفّر دائمًا الحقلان "المعرّف" وalternateLink، ولكن قد لا تتوفّر حقول أخرى (مثل "العنوان").

مرفق

تمت إضافة مرفق إلى عمل الطالب في المهمة.

عند إنشاء مرفقات، لا يمكن ضبط الحقل form.

تمثيل JSON 
{

  // Union field attachment can be only one of the following:
  "driveFile": {
    object (DriveFile)
  },
  "youTubeVideo": {
    object (YouTubeVideo)
  },
  "link": {
    object (Link)
  },
  "form": {
    object (Form)
  }
  // End of list of possible types for union field attachment.
}
الحقول
حقل الدمج attachment بيانات المرفقات يمكن أن تكون attachment إحدى القيم التالية فقط:
driveFile

object (DriveFile)

مرفق ملف Google Drive
youTubeVideo

object (YouTubeVideo)

مرفق فيديو على YouTube
form

object (Form)

مرفق من "نماذج Google"

ShortAnswerSubmission

عمل الطالب على سؤال ذي إجابة قصيرة

تمثيل JSON 
{
  "answer": string
}
الحقول
answer

string

إجابة الطالب عن سؤال ذي إجابة قصيرة

MultipleChoiceSubmission

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

تمثيل JSON 
{
  "answer": string
}
الحقول
answer

string

اختيار الطالب

SubmissionHistory

سجلّ عملية الإرسال ويشمل ذلك حاليًا سجلّات الولاية والصف.

تمثيل JSON 
{

  // Union field type can be only one of the following:
  "stateHistory": {
    object (StateHistory)
  },
  "gradeHistory": {
    object (GradeHistory)
  }
  // End of list of possible types for union field type.
}
الحقول
حقل الدمج type نوع SubmissionHistory، ويمكن أن يكون StateHistory أو GradeHistory. يمكن أن تكون type إحدى القيم التالية فقط:
stateHistory

object (StateHistory)

تمثّل هذه السمة معلومات سجلّ حالة الطلب، إذا كانت متوفّرة.
gradeHistory

object (GradeHistory)

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

StateHistory

سجلّ كل حالة مرّت بها عملية الإرسال هذه

تمثيل JSON 
{
  "state": enum (State),
  "stateTimestamp": string,
  "actorUserId": string
}
الحقول
state

enum (State)

مرحلة مسار سير العمل
stateTimestamp

string (Timestamp format)

الوقت الذي انتقل فيه الطلب إلى هذه الحالة

يستخدم هذا النوع RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا Z-normalized ويستخدم 0 أو 3 أو 6 أو 9 أرقام كسرية. يتم أيضًا قبول الإزاحات غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
actorUserId

string

المعلّم أو الطالب الذي أجرى التغيير

الحالة

الحالات المحتملة التي يمكن أن يكون فيها طلب.

عمليات التعداد
STATE_UNSPECIFIED لم يتم تحديد أي ولاية. ولا يُفترَض أن يتم عرض هذا الخطأ أبدًا.
CREATED تم إنشاء الطلب.
TURNED_IN سلّم الطالب مستندًا تم تعيينه، وقد يكون هذا المستند نموذجًا أو لا يكون.
RETURNED أرجع المعلّم المستند المخصّص إلى الطالب.
RECLAIMED_BY_STUDENT سلّم الطالب المستند المحدّد، ثم اختار "إلغاء التسليم" للواجب، ما أتاح له التحكّم فيه مجددًا كمالك.
STUDENT_EDITED_AFTER_TURN_IN عدّل الطالب إرساله بعد تسليمه. يتم استخدامها حاليًا فقط في "الأسئلة" عندما يعدّل الطالب إجابته.

GradeHistory

سجلّ كل درجة تم الحصول عليها في هذا الواجب

تمثيل JSON 
{
  "pointsEarned": number,
  "maxPoints": number,
  "gradeTimestamp": string,
  "actorUserId": string,
  "gradeChangeType": enum (GradeChangeType)
}
الحقول
pointsEarned

number

بسط الدرجة في هذا الوقت في سجلّ درجات الواجب.
maxPoints

number

مقياس الدرجة في هذا الوقت في سجلّ درجات عمليات التسليم.
gradeTimestamp

string (Timestamp format)

عندما تم تغيير درجة المهمة التي تم إرسالها

يستخدم هذا النوع RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا Z-normalized ويستخدم 0 أو 3 أو 6 أو 9 أرقام كسرية. يتم أيضًا قبول الإزاحات غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
actorUserId

string

المعلّم الذي أجرى تغييرًا في الدرجة
gradeChangeType

enum (GradeChangeType)

نوع التغيير في الدرجة في هذا الوقت في سجلّ درجات المهمة.

GradeChangeType

أنواع تغييرات الدرجات المحتملة.

عمليات التعداد
UNKNOWN_GRADE_CHANGE_TYPE لم يتم تحديد نوع تغيير العلامة. ولا يُفترَض أن يتم عرض هذا الخطأ أبدًا.
DRAFT_GRADE_POINTS_EARNED_CHANGE تغيير في بسط درجة المسودة
ASSIGNED_GRADE_POINTS_EARNED_CHANGE تغيير في بسط الدرجة المحدّدة
MAX_POINTS_CHANGE تغيير في المقام الخاص بالدرجة

الطُرق

get

 تعرض هذه الطريقة عملية إرسال من طالب.

list

 تعرض هذه الطريقة قائمة بالمهام التي أرسلها الطلاب والتي يُسمح لمقدّم الطلب بالاطّلاع عليها، مع مراعاة نطاقات OAuth للطلب.

modifyAttachments

 تعديل مرفقات عملية إرسال الطالب

patch

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

reclaim

 تستردّ هذه الطريقة مهمة أرسلها طالب نيابةً عن الطالب الذي يملكها.

return

 تعرض هذه الطريقة عملية إرسال من طالب.

turnIn

 تسليم مهمة أرسلها طالب