- المرجع: 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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
updateTime |
تاريخ آخر تعديل لعملية الإرسال هذه ويمكن إلغاء ضبط هذا الإعداد إذا لم يتمكّن الطالب من الوصول إلى هذا العنصر. للقراءة فقط. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
state |
حالة هذا الإرسال. للقراءة فقط. |
late |
ما إذا كان هذا الإرسال متأخرًا. للقراءة فقط. |
draftGrade |
درجة اختيارية في انتظار المراجعة. وفي حال ترك هذه السياسة بدون ضبط، لن يتم ضبط أي درجة. يجب أن تكون هذه القيمة غير سالبة. يُسمح بالقيم العشرية (أي التي لا تمثّل عددًا صحيحًا)، ولكن يتم تقريبها إلى منزلتين عشريتين. لا يمكن لأحد سوى معلّمي الدورة التدريبية الاطّلاع على هذا الاسم وتعديله. |
assignedGrade |
درجة اختيارية. وفي حال ترك هذه السياسة بدون ضبط، لن يتم ضبط أي درجة. يجب أن تكون هذه القيمة غير سالبة. يُسمح بالقيم العشرية (أي التي لا تمثّل عددًا صحيحًا)، ولكن يتم تقريبها إلى منزلتين عشريتين. يمكن تعديل هذا الخيار فقط من قِبل معلّمي الدورة التدريبية. |
rubricId |
النتائج فقط. معرّف نموذج التقييم المرفق حاليًا بهذا العمل في الدورة التدريبية ويُستخدَم لوضع الدرجات على المهام التي أرسلها الطالب ويكون هذا المعرّف فارغًا في حال عدم توفّر قواعد تقييم. ويُظهر رقم التعريف هذا قواعد التقييم النشطة حاليًا. تتغير إذا حذف المعلمون نموذج التقييم وأعد إنشائه. للقراءة فقط. |
draftRubricGrades |
في انتظار درجات قواعد التقييم استنادًا إلى معايير قواعد التقييم. وتكون هذه الخريطة فارغة إذا لم يكن هناك قواعد تقييم مرفقة بعمل الدورة التدريبية هذا أو إذا تم إرفاق نموذج تقييم، ولكن لم يتم تعيين درجات لأي معايير. لا تتم تعبئة الإدخالات إلا للدرجات التي تم ضبطها. المفتاح: رقم تعريف معيار قواعد التقييم. للقراءة فقط. عنصر يحتوي على قائمة بأزواج |
assignedRubricGrades |
تم تخصيص درجات قواعد التقييم استنادًا إلى "معايير قواعد التقييم". تكون هذه الخريطة فارغة إذا لم يكن هناك نموذج تقييم مرفق بعمل الدورة التدريبية هذا أو إذا تم إرفاق نموذج تقييم، ولكن لم يتم تعيين درجات على أي من المعايير. لا تتم تعبئة الإدخالات إلا للدرجات التي تم ضبطها. المفتاح: رقم تعريف معيار قواعد التقييم. للقراءة فقط. عنصر يحتوي على قائمة بأزواج |
alternateLink |
رابط مطلق إلى الإرسال في واجهة مستخدم الويب في Classroom. للقراءة فقط. |
courseWorkType |
تمثّل هذه السمة نوع عمل الدورة التدريبية المخصّص له. للقراءة فقط. |
associatedWithDeveloper |
ما إذا كان هذا الإرسال الذي أرسله الطالب مرتبطًا بمشروع Play Console الذي قدّم الطلب لمزيد من التفاصيل، يُرجى الانتقال إلى للقراءة فقط. |
submissionHistory[] |
سجل الإرسال (بما في ذلك سجلات الولاية والدرجات). للقراءة فقط. |
previewVersion |
النتائج فقط. إصدار المعاينة من واجهة برمجة التطبيقات. ويجب ضبط هذا الخيار للوصول إلى إمكانات واجهة برمجة التطبيقات الجديدة المتوفّرة للمطوّرين في "برنامج المعاينة". |
حقل الاتحاد content . محتوى الإرسال: ويعتمد النوع المحدّد على قيمة course_work_type . يمكن أن يكون content واحدًا فقط مما يلي: |
|
assignmentSubmission |
إرسال المحتوى عندما يكون خيار الدورة التدريبية ASSIGNMENT هو ASSIGNMENT. يمكن للطلاب تعديل هذا المحتوى باستخدام " |
shortAnswerSubmission |
يتم إرسال المحتوى عندما يكون خيار الدورة التدريبية SHORT_ANSWER_QUESTION. |
multipleChoiceSubmission |
يمكنك إرسال المحتوى عندما يكون خيار courseWorkType هو 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 . نوع سجل التقديم، ويمكن أن يكون واحدًا من StateHistory أو DurationHistory. يمكن أن يكون type واحدًا فقط مما يلي: |
|
stateHistory |
معلومات سجلّ الولاية لعملية الإرسال، إذا كانت متوفّرة |
gradeHistory |
معلومات سجلّ الدرجات لعملية الإرسال، إذا كانت متوفّرة. |
StateHistory
سجلّ كل ولاية كانت نتيجة عملية الإرسال هذه
تمثيل JSON |
---|
{
"state": enum ( |
الحقول | |
---|---|
state |
مرحلة سير العمل. |
stateTimestamp |
عندما وصلت عملية الإرسال إلى هذه الحالة طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
actorUserId |
المعلّم الذي قام بتغيير الدرجة. |
gradeChangeType |
نوع التغيير في الدرجة في الوقت الحالي في سجلّ درجات الإرسال |
GradeChangeType
أنواع التغييرات المحتملة في الدرجة.
عمليات التعداد | |
---|---|
UNKNOWN_GRADE_CHANGE_TYPE |
لم يتم تحديد أي نوع تغيير في الدرجة. ولا يجب إرجاعها مطلقًا. |
DRAFT_GRADE_POINTS_EARNED_CHANGE |
تغيير في بسط الدرجة الأولية |
ASSIGNED_GRADE_POINTS_EARNED_CHANGE |
تغيير في بسط الدرجة المعينة. |
MAX_POINTS_CHANGE |
تغيير في المقام. |
الطُرق |
|
---|---|
|
تعرض المهمة التي أرسلها الطالب. |
|
عرض قائمة بعمليات إرسال الطلاب التي يُسمح لمقدِّم الطلب بالاطّلاع عليها، مع مراعاة نطاقات OAuth للطلب |
|
لتعديل المرفقات التي يرسلها الطالب. |
|
لتعديل حقل واحد أو أكثر من المهام التي أرسلها الطالب. |
|
استرداد طلب أرسله طالب نيابةً عن الطالب الذي يملكه. |
|
تعرض المهمة التي أرسلها الطالب. |
|
تسليم المهمة التي أرسلها الطالب |