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)

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

 يسلّم الطالب تسليمًا.