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,
  "alternateLink": string,
  "courseWorkType": enum (CourseWorkType),
  "associatedWithDeveloper": boolean,
  "submissionHistory": [
    {
      object (SubmissionHistory)
    }
  ],

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

درجة اختيارية. وفي حال ترك هذه السياسة بدون ضبط، لم يتم ضبط أي درجة. يجب أن تكون هذه القيمة غير سالبة. ويُسمح بالقيم العشرية (أي عدد غير صحيح) ولكن يتم تقريبها إلى منزلتَين عشريتَين.

لا يمكن تعديل هذا الإعداد إلا من قِبل المعلمين في الدورة التدريبية.

courseWorkType

enum (CourseWorkType)

نوع عمل الدورة التدريبية الذي تم إرسال هذا من أجله.

للقراءة فقط.

associatedWithDeveloper

boolean

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

يُرجى الاطّلاع على courseWork.create لمزيد من التفاصيل.

للقراءة فقط.

submissionHistory[]

object (SubmissionHistory)

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

للقراءة فقط.

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

object (AssignmentSubmission)

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

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

shortAnswerSubmission

object (ShortAnswerSubmission)

يتم إرسال المحتوى عندما تكون قيمة WorkWorkType هي {/8}_ANSWER_QUESTION.

multipleChoiceSubmission

object (MultipleChoiceSubmission)

يتم إرسال المحتوى عندما تكون قيمة URLWorkType هي MULTipLE_CHOICE_QUESTION.

حالة الإرسال

الحالات المحتملة لإرسالات الطلاب

عمليات التعداد
SUBMISSION_STATE_UNSPECIFIED لم يتم تحديد أي ولاية. ولا يجوز إرجاع هذه القيمة.
NEW لم يسبق للطالب الوصول إلى النموذج الذي أرسلته. لا يتم إرجاع المرفقات ولا يتم ضبط الطوابع الزمنية.
CREATED تم إنشائه.
TURNED_IN تم تسليمها إلى المُعلّم.
RETURNED تم إرجاعه إلى الطالب.
RECLAIMED_BY_STUDENT اختار الطالب ا &لنقلاة&بالنسبة إلى المهمة:

إرسال المهمة

عمل الطالب في مهمة دراسية.

تمثيل 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".

إرسال إجابة قصيرة

يعمل الطالب على سؤال ذي إجابة قصيرة.

تمثيل JSON
{
  "answer": string
}
الحقول
answer

string

ردّ الطالب على سؤال ذي إجابة قصيرة

إرسال خيارات متعدّدة

عمل الطالب على سؤال خيارات متعدّدة

تمثيل JSON
{
  "answer": string
}
الحقول
answer

string

اختيار طالب.

سجلّ عمليات الإرسال

سجلّ الإرسال. ويشمل ذلك حاليًا سجلّ الولاية والدرجات.

تمثيل 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 نوع من HistoryHistory، يمكن أن يكون من StateHistory, gradHistory. لا يمكن أن يكون type إلا واحدًا مما يلي:
stateHistory

object (StateHistory)

معلومات سجلّ حالات الإرسال، إن وجدت.

gradeHistory

object (GradeHistory)

معلومات سجلّ الدرجات للإرسال، إن وجدت.

سجلّ الولاية

سجلّ كل حالة تم فيها إرسال هذا الطلب.

تمثيل 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 عدّل الطالب إرساله بعد تسليمه. يتم استخدامها حاليًا من خلال الأسئلة فقط، عندما يعدّل الطالب إجابته.

سجلّ الدرجات

سجلّ كل درجة في هذا الإرسال.

تمثيل 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)

نوع تغيير الدرجة في الوقت الحالي في سجلّ درجات الإرسال.

نوع تغيير الدرجة

أنواع تغييرات الدرجات المحتملة.

عمليات التعداد
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

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