- المرجع: إرسال الطالب
- RubricGrade
- AssignmentSubmission
- المرفق
- ShortAnswerSubmission
- MultipleChoiceSubmission
- SubmissionHistory
- StateHistory (سجلّ الولاية)
- الولاية
- GradeHistory
- GradeChangeType
- الطُرق
المورد: إرسال الطالب
تقديم الطلاب لأعمال الدورة التدريبية
يتم إنشاء StudentSubmission
عنصر عند إنشاء عنصر CourseWork
.
بالنسبة إلى عمليات إرسال الطلاب التي لم يتم الوصول إليها مطلقًا (أي باستخدام state
= جديد) قد لا يتم تحديد وقت لإنشاء المحتوى أو تعديله.
تمثيل JSON |
---|
{ "courseId": string, "courseWorkId": string, "id": string, "userId": string, "creationTime": string, "updateTime": string, "state": enum ( |
الحقول | |
---|---|
courseId |
تمثّل هذه السمة معرّف الدورة التدريبية. للقراءة فقط: |
courseWorkId |
معرّف الدورة التدريبية الذي يتوافق معه هذا الإجراء. للقراءة فقط: |
id |
المعرِّف الذي تخصيصه Classroom للطالب المَهمّة الدراسية هذا فريد من نوعه بين الإرسالات لعمل الدورة ذات الصلة. للقراءة فقط: |
userId |
معرّف للطالب الذي يملك عملية الإرسال هذه للقراءة فقط: |
creationTime |
وقت إنشاء هذا الإرسال. يمكن ترك هذه السياسة بدون ضبط إذا لم يتمكّن الطالب من الوصول إلى هذا العنصر. للقراءة فقط: طابع زمني بتنسيق RFC3339 UTC "Zulu" بدقة نانو ثانية وما يصل إلى تسعة أرقام كسور. أمثلة: |
updateTime |
وقت آخر تعديل لعملية الإرسال هذه يمكن ترك هذه السياسة بدون ضبط إذا لم يتمكّن الطالب من الوصول إلى هذا العنصر. للقراءة فقط: طابع زمني بتنسيق RFC3339 UTC "Zulu" بدقة نانو ثانية وما يصل إلى تسعة أرقام كسور. أمثلة: |
state |
حالة هذه العينة التي تم إرسالها. للقراءة فقط: |
late |
ما إذا كان هذا الإرسال متأخرًا. للقراءة فقط: |
draftGrade |
درجة معلّقة اختيارية. في حال ترك هذه السياسة بدون ضبط، لن يتم ضبط أي درجة. يجب أن تكون هذه القيمة غير سالبة. يُسمح بالقيم العشرية (أي التي لا تمثل عددًا صحيحًا)، ولكن يتم تقريبها إلى أقرب جزء من مائة. لا يظهر هذا الإعداد إلّا لمعلّمي الدورة التدريبية ويمكن تعديله. |
assignedGrade |
درجة اختيارية. في حال ترك هذه السياسة بدون ضبط، لن يتم ضبط أي درجة. يجب أن تكون هذه القيمة غير سالبة. يُسمح بالقيم العشرية (أي التي لا تمثل عددًا صحيحًا)، ولكن يتم تقريبها إلى أقرب جزء من مائة. لا يمكن تعديل هذا الإعداد إلا من قِبل معلّمي الدورة التدريبية. |
rubricId |
إخراج فقط. معرّف قواعد التقييم المرفقة حاليًا بأعمال الدورة التدريبية هذه والمستخدَمة لوضع درجات على مَهمة الطالب هذه. ويكون هذا المعرّف فارغًا في حال عدم توفّر قواعد تقييم. يعكس هذا المعرّف قواعد التقييم النشطة حاليًا، وتتغيّر إذا حذف المعلّمون قواعد التقييم وأعادوا إنشائها. للقراءة فقط: |
draftRubricGrades |
في انتظار تقييمات قواعد التقييم استنادًا إلى معاييرها. تكون هذه الخريطة فارغة إذا لم يكن هناك قواعد تقييم مرفقة بعمل الدورة التدريبية أو إذا تم إرفاق نموذج تقييم، ولكن لم يتم وضع درجات لأي معايير. تتم تعبئة الإدخالات فقط للدرجات التي تم ضبطها. المفتاح: رقم تعريف معيار قاعدة التقييم. للقراءة فقط: كائن يحتوي على قائمة من |
assignedRubricGrades |
تم تخصيص درجات قواعد التقييم وفقًا لـ "معايير نموذج التقييم". تكون هذه الخريطة فارغة إذا لم يكن هناك قواعد تقييم مرفقة بعمل الدورة التدريبية أو إذا تم إرفاق نموذج تقييم، ولكن لم يتم وضع درجات لأي معايير. تتم تعبئة الإدخالات فقط للدرجات التي تم ضبطها. المفتاح: رقم تعريف معيار قاعدة التقييم. للقراءة فقط: كائن يحتوي على قائمة من |
alternateLink |
رابط مطلق إلى المهمة الدراسية في واجهة مستخدم الويب في Classroom للقراءة فقط: |
courseWorkType |
نوع العمل الذي تم تخصيصه لهذه الدورة التدريبية للقراءة فقط: |
associatedWithDeveloper |
ما إذا كان إرسال الطالب هذا مرتبطًا بمشروع Play Console الذي ينشئ الطلب. لمزيد من التفاصيل، انتقِل إلى للقراءة فقط: |
submissionHistory[] |
تاريخ العينة التي تم إرسالها (بما في ذلك سجلات الولاية والدرجات). للقراءة فقط: |
previewVersion |
إخراج فقط. إصدار المعاينة لواجهة برمجة التطبيقات. يجب ضبط هذا الخيار للوصول إلى إمكانات واجهة برمجة التطبيقات الجديدة المتاحة للمطوّرين في "برنامج الاستخدام المبكّر". |
حقل الاتحاد content . محتوى الإرسال: ويعتمد النوع المحدد على قيمة course_work_type . يمكن أن تكون السمة "content " واحدة فقط مما يلي: |
|
assignmentSubmission |
يجب إرسال المحتوى عندما تكون قيمة الدورة التدريبيةcourseWorkType مضبوطة على ASSIGNMENT. يمكن للطلاب تعديل هذا المحتوى باستخدام " |
shortAnswerSubmission |
يجب إرسال المحتوى عندما تكون قيمة الدورة التدريبية هي SHORT_ANSWER_QUESTION. |
multipleChoiceSubmission |
يجب إرسال محتوى عندما تكون قيمة الدورة التدريبية هي MULTIPLE_CHOICE_QUESTION. |
RubricGrade
تم وضع درجة نموذج تقييم لما أرسله الطالب. هناك إدخال واحد على الأكثر لكل معيار من معايير قواعد التقييم.
تمثيل JSON |
---|
{ "criterionId": string, "levelId": string, "points": number } |
الحقول | |
---|---|
criterionId |
اختياريّ. معرِّف المعيار. |
levelId |
اختياريّ. رقم تعريف المستوى الاختياري للمستوى المختار. إذا كان الحقل فارغًا، لم يتم اختيار أي مستوى. |
points |
اختياريّ. نقاط اختيارية يتم تحديدها لهذا المعيار، ويتم تحديدها عادةً استنادًا إلى المستوى. وقد تتضمّن المستويات نقاطًا أو لا تتضمّنها. في حال ترك هذه السياسة بدون ضبط، لم يتم تحديد أي نقاط لهذا المعيار. |
AssignmentSubmission
عمل الطالب في مهمة دراسية
تمثيل JSON |
---|
{
"attachments": [
{
object ( |
الحقول | |
---|---|
attachments[] |
المرفقات التي أضافها الطالب. قد لا تتوفر ملفات Drive المرتبطة بالمواد ذات وضع المشاركة STUDENT_COPY بعد إذا لم يتمكن الطالب من الوصول إلى المهمة في Classroom. لا تتم تعبئة بعض البيانات الوصفية للمرفقات إلا إذا كان لدى المستخدم الذي قدّم الطلب إذن بالوصول إليها. يكون حقلا المعرّف والرابط البديل متاحَين دائمًا، ولكن قد لا يكون هناك حقول أخرى (مثل العنوان). |
التعلّق
تمت إضافة المرفق إلى عمل المهام الدراسية للطلاب.
عند إنشاء مرفقات، لا يمكن ضبط الحقل form
.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد attachment . بيانات المرفقات يمكن أن تكون السمة "attachment " واحدة فقط مما يلي: |
|
driveFile |
مرفق ملف في Google Drive. |
youTubeVideo |
مرفق فيديو على YouTube |
link |
مرفق الرابط |
form |
مرفق في "نماذج Google" |
ShortAnswerSubmission
تمثّل هذه السمة عمل الطالب للإجابة عن سؤال ذي إجابة قصيرة.
تمثيل JSON |
---|
{ "answer": string } |
الحقول | |
---|---|
answer |
إجابة الطالب على سؤال ذي إجابة قصيرة. |
MultipleChoiceSubmission
عمل الطالب للإجابة عن سؤال متعدد الخيارات.
تمثيل JSON |
---|
{ "answer": string } |
الحقول | |
---|---|
answer |
هذا هو الخيار الذي يختاره الطالب. |
SubmissionHistory
سجلّ الإرسال. ويتضمن ذلك حاليًا سجلات الحالة والدرجات.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد type . يمكن أن يكون نوع "سجلّ الإرسال" أحد أنواع "سجلّ الولاية" أو "سجلّ الدرجات". يمكن أن تكون السمة "type " واحدة فقط مما يلي: |
|
stateHistory |
معلومات سجلّ الولاية الخاصة بعملية الإرسال، في حال توفّرها. |
gradeHistory |
معلومات سجلّ الدرجات للمهام الدراسية المُرسَلة، في حال توفّرها |
StateHistory
سجلّ كل حالة تمت فيها عملية الإرسال هذه.
تمثيل JSON |
---|
{
"state": enum ( |
الحقول | |
---|---|
state |
مرحلة مسار سير العمل. |
stateTimestamp |
عند دخول عملية الإرسال هذه الحالة. طابع زمني بتنسيق RFC3339 UTC "Zulu" بدقة نانو ثانية وما يصل إلى تسعة أرقام كسور. أمثلة: |
actorUserId |
المُعلّم أو الطالب اللذان أجرى التغيير |
الحالة
الحالات المحتملة التي يمكن أن تظهر فيها العينة.
عمليات التعداد | |
---|---|
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 ( |
الحقول | |
---|---|
pointsEarned |
بسط الدرجة في هذا الوقت في سجل درجات الإرسال. |
maxPoints |
مقام الدرجة في هذا الوقت في سجل درجات التسليم. |
gradeTimestamp |
عند تغيير درجة الإرسال. طابع زمني بتنسيق RFC3339 UTC "Zulu" بدقة نانو ثانية وما يصل إلى تسعة أرقام كسور. أمثلة: |
actorUserId |
المعلّم الذي أجرى تغيير الدرجة. |
gradeChangeType |
هذا الوقت هو نوع تغيير الدرجة في سجلّ درجات المهام المُرسَلة. |
GradeChangeType
أنواع تغيير الدرجات المحتملة.
عمليات التعداد | |
---|---|
UNKNOWN_GRADE_CHANGE_TYPE |
لم يتم تحديد نوع تغيير الدرجة. يجب عدم إرجاع هذه الرسالة مطلقًا. |
DRAFT_GRADE_POINTS_EARNED_CHANGE |
تغيير في بسط الدرجة الأولية. |
ASSIGNED_GRADE_POINTS_EARNED_CHANGE |
تغيير في بسط الدرجة المعينة. |
MAX_POINTS_CHANGE |
يشير ذلك المصطلح إلى تغيير في مقام الدرجة. |
الطُرق |
|
---|---|
|
تعرض المَهمّة الدراسية التي أرسلها الطالب. |
|
تعرض قائمة بعمليات إرسال الطلاب التي يُسمح لمقدِّم الطلب بالاطّلاع عليها، مع مراعاة نطاقات OAuth للطلب. |
|
تعديل مرفقات تسليم الطالب |
|
تعديل حقل واحد أو أكثر من الحقول المُرسَلة من قِبل الطالب |
|
استرداد أي عيّنة أرسلها الطالب نيابةً عن الطالب الذي يملكه |
|
تعرض المَهمّة الدراسية التي أرسلها الطالب. |
|
تسليم مهمة الطالب |