- المرجع: StudentSubmission
- 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 |
يتم إرسال محتوى عندما تكون قيمة الدورة التدريبيةcourseWorkType هي 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 للطلب. |
|
لتعديل مرفقات تسليم الطالب |
|
تعدِّل حقلاً واحدًا أو أكثر في العناصر التي أرسلها الطالب. |
|
استعادة المحتوى الذي أرسله الطالب بالنيابة عن الطالب الذي يملكه |
|
تعرض تسليمًا للطالب. |
|
يسلّم الطالب تسليمًا. |