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

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

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

للقراءة فقط:
submissionHistory[]

object (SubmissionHistory)

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

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

object (AssignmentSubmission)

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

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

object (ShortAnswerSubmission)

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

object (MultipleChoiceSubmission)

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

إرسال المهمة

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

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

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

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

عمل الطالب للإجابة عن سؤال متعدد الخيارات.

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

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