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)

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

للقراءة فقط.

يجب أن يكون طابعًا زمنيًا بالتنسيق 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"
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.

لا تتم تعبئة بعض البيانات الوصفية للمرفق إلا إذا كان لدى المستخدم الذي يطلبها إذن بالوصول إليها. يكون حقلَا Identifier و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)

وقت دخول العينة المرسَلة إلى هذه الحالة

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
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)

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

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
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

 إرسال عمل تقدّمه مؤسسة تعليمية