REST Resource: courses.courseWork.studentSubmissions

المرجع: إرسال الطالب

تسليم الطالب لعمل الدورة التدريبية

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

قد لا يكون هناك وقت لإنشاء المحتوى أو وقت تعديل المهام التي يرسلها الطلاب والتي لم يتم الوصول إليها من قبل (أي في حال استخدام state = جديد).

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

updateTime

string (Timestamp format)

تاريخ آخر تعديل لعملية الإرسال هذه ويمكن إلغاء ضبط هذا الإعداد إذا لم يتمكّن الطالب من الوصول إلى هذا العنصر.

للقراءة فقط.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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

ما إذا كان هذا الإرسال الذي أرسله الطالب مرتبطًا بمشروع Play Console الذي قدّم الطلب

لمزيد من التفاصيل، يُرجى الانتقال إلى courseWork.create.

للقراءة فقط.

submissionHistory[]

object (SubmissionHistory)

سجل الإرسال (بما في ذلك سجلات الولاية والدرجات).

للقراءة فقط.

previewVersion

enum (PreviewVersion)

النتائج فقط. إصدار المعاينة من واجهة برمجة التطبيقات. ويجب ضبط هذا الخيار للوصول إلى إمكانات واجهة برمجة التطبيقات الجديدة المتوفّرة للمطوّرين في "برنامج المعاينة".

حقل الاتحاد content. محتوى الإرسال: ويعتمد النوع المحدّد على قيمة course_work_type. يمكن أن يكون content واحدًا فقط مما يلي:
assignmentSubmission

object (AssignmentSubmission)

إرسال المحتوى عندما يكون خيار الدورة التدريبية ASSIGNMENT هو ASSIGNMENT.

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

shortAnswerSubmission

object (ShortAnswerSubmission)

يتم إرسال المحتوى عندما يكون خيار الدورة التدريبية 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.

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

مرفق

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

عند إنشاء المرفقات، لا يمكن ضبط الحقل 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. نوع سجل التقديم، ويمكن أن يكون واحدًا من StateHistory أو DurationHistory. يمكن أن يكون 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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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

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