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

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