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 "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

ما إذا كان إرسال الطالب هذا مرتبطًا بمشروع Play Console الذي ينشئ الطلب.

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

للقراءة فقط:

submissionHistory[]

object (SubmissionHistory)

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

للقراءة فقط:

previewVersion

enum (PreviewVersion)

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

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

object (AssignmentSubmission)

يجب إرسال المحتوى عندما تكون قيمة الدورة التدريبيةcourseWorkType مضبوطة على ASSIGNMENT.

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

shortAnswerSubmission

object (ShortAnswerSubmission)

يجب إرسال المحتوى عندما تكون قيمة الدورة التدريبية هي SHORT_ANSWER_QUESTION.

multipleChoiceSubmission

object (MultipleChoiceSubmission)

يجب إرسال محتوى عندما تكون قيمة الدورة التدريبية هي 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. يمكن أن يكون نوع "سجلّ الإرسال" أحد أنواع "سجلّ الولاية" أو "سجلّ الدرجات". يمكن أن تكون السمة "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

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