- المورد: تقديم طلب الطالب
- حالة الإرسال
- مهمة فرعية
- المُرفَق
- ShortAnswerSubmission
- إتاحة خيارات متعدّدة
- SubصمHistory
- StateHistory
- الولاية
- درجات السجلّ
- نوع التغيير
- الطُرق
المورد: ويب الطالب
إرسال الطلاب للعمل في دورة تدريبية.
يتم إنشاء عناصر 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 |
درجة اختيارية. وفي حال ترك هذه السياسة بدون ضبط، لم يتم ضبط أي درجة. يجب أن تكون هذه القيمة غير سالبة. ويُسمح بالقيم العشرية (أي عدد غير صحيح) ولكن يتم تقريبها إلى منزلتَين عشريتَين. لا يمكن تعديل هذا الإعداد إلا من قِبل المعلمين في الدورة التدريبية. |
alternateLink |
رابط مطلق للإرسال إلى واجهة مستخدم Classroom على الويب. للقراءة فقط. |
courseWorkType |
نوع عمل الدورة التدريبية الذي تم إرسال هذا من أجله. للقراءة فقط. |
associatedWithDeveloper |
ما إذا كان إرسال الطالب هذا مرتبطًا بمشروع Developer Console الذي يقدّم الطلب. يُرجى الاطّلاع على للقراءة فقط. |
submissionHistory[] |
سجلّ الإرسال (بما في ذلك سجلات الولاية والدرجات). للقراءة فقط. |
حقل الاتحاد content محتوى الإرسال ويعتمد النوع المحدّد على قيمة course_work_type . لا يمكن أن يكون content إلا واحدًا مما يلي: |
|
assignmentSubmission |
يتم إرسال المحتوى عندما تكون قيمة coursesWorkType هي مهمة. يمكن للطلاب تعديل هذا المحتوى باستخدام |
shortAnswerSubmission |
يتم إرسال المحتوى عندما تكون قيمة WorkWorkType هي {/8}_ANSWER_QUESTION. |
multipleChoiceSubmission |
يتم إرسال المحتوى عندما تكون قيمة URLWorkType هي MULTipLE_CHOICE_QUESTION. |
حالة الإرسال
الحالات المحتملة لإرسالات الطلاب
عمليات التعداد | |
---|---|
SUBMISSION_STATE_UNSPECIFIED |
لم يتم تحديد أي ولاية. ولا يجوز إرجاع هذه القيمة. |
NEW |
لم يسبق للطالب الوصول إلى النموذج الذي أرسلته. لا يتم إرجاع المرفقات ولا يتم ضبط الطوابع الزمنية. |
CREATED |
تم إنشائه. |
TURNED_IN |
تم تسليمها إلى المُعلّم. |
RETURNED |
تم إرجاعه إلى الطالب. |
RECLAIMED_BY_STUDENT |
اختار الطالب ا &لنقلاة&بالنسبة إلى المهمة: |
إرسال المهمة
عمل الطالب في مهمة دراسية.
تمثيل JSON |
---|
{
"attachments": [
{
object ( |
الحقول | |
---|---|
attachments[] |
المرفقات التي أضافها الطالب. قد لا تكون ملفات Drive التي تتوافق مع المواد مع وضع المشاركة STUDENT_COPY متاحة حتى الآن إذا لم يدخل الطالب إلى المهمة الدراسية في Classroom. لا تتم تعبئة بعض البيانات الوصفية للمرفقات إلا إذا كان المستخدم صاحب الطلب لديه إذن بالوصول إليها. يتوفّر دائمًا حقلَا المعرّف والرابط البديل، ولكن قد لا تتوفّر الحقول الأخرى (مثل العنوان). |
مُرفَق
تمت إضافة المرفق إلى عمل مهمة الطالب.
عند إنشاء المرفقات، لا يكون الإعداد form
متاحًا.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد attachment بيانات المرفقات لا يمكن أن يكون attachment إلا واحدًا مما يلي: |
|
driveFile |
مرفق ملف Google Drive |
youTubeVideo |
مرفق فيديو YouTube. |
link |
مرفق الرابط |
form |
مرفق "نماذج Google". |
إرسال إجابة قصيرة
يعمل الطالب على سؤال ذي إجابة قصيرة.
تمثيل JSON |
---|
{ "answer": string } |
الحقول | |
---|---|
answer |
ردّ الطالب على سؤال ذي إجابة قصيرة |
إرسال خيارات متعدّدة
عمل الطالب على سؤال خيارات متعدّدة
تمثيل JSON |
---|
{ "answer": string } |
الحقول | |
---|---|
answer |
اختيار طالب. |
سجلّ عمليات الإرسال
سجلّ الإرسال. ويشمل ذلك حاليًا سجلّ الولاية والدرجات.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد type نوع من HistoryHistory، يمكن أن يكون من StateHistory, gradHistory. لا يمكن أن يكون type إلا واحدًا مما يلي: |
|
stateHistory |
معلومات سجلّ حالات الإرسال، إن وجدت. |
gradeHistory |
معلومات سجلّ الدرجات للإرسال، إن وجدت. |
سجلّ الولاية
سجلّ كل حالة تم فيها إرسال هذا الطلب.
تمثيل JSON |
---|
{
"state": enum ( |
الحقول | |
---|---|
state |
مرحلة مسار سير العمل. |
stateTimestamp |
وقت دخول حالة الإرسال هذه. طابع زمني بتنسيق RFC3339 UTC "Zulu" مع دقة نانو ثانية وما يصل إلى تسعة أرقام كسورية أمثلة: |
actorUserId |
المعلّم أو الطالب الذي أجرى التغيير. |
الولاية
الحالات المحتملة لإرسال الطلب.
عمليات التعداد | |
---|---|
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 ( |
الحقول | |
---|---|
pointsEarned |
بسط الدرجة في هذا الوقت في سجل درجات الإرسال. |
maxPoints |
مقام الدرجة في هذا الوقت في سجل درجات الإرسال. |
gradeTimestamp |
تم تغيير درجة الإرسال. طابع زمني بتنسيق RFC3339 UTC "Zulu" مع دقة نانو ثانية وما يصل إلى تسعة أرقام كسورية أمثلة: |
actorUserId |
المعلّم الذي أجرى تغيير الدرجة. |
gradeChangeType |
نوع تغيير الدرجة في الوقت الحالي في سجلّ درجات الإرسال. |
نوع تغيير الدرجة
أنواع تغييرات الدرجات المحتملة.
عمليات التعداد | |
---|---|
UNKNOWN_GRADE_CHANGE_TYPE |
لم يتم تحديد نوع لتغيير الدرجة. ولا يجوز إرجاع هذه القيمة. |
DRAFT_GRADE_POINTS_EARNED_CHANGE |
تغيير في بسط مسودة الدرجة. |
ASSIGNED_GRADE_POINTS_EARNED_CHANGE |
تغيير في بسط الدرجة الممنوحة. |
MAX_POINTS_CHANGE |
تغيير في مقام الدرجة |
الطُرق |
|
---|---|
|
يتم إرسال المهام التي أرسلها الطلاب. |
|
عرض قائمة بإرسالات الطالب التي يُسمح لمقدِّم الطلب بمشاهدتها، مع مراعاة نطاقات OAuth للطلب. |
|
لتعديل مرفقات تسليم الطلاب. |
|
لتعديل حقل واحد أو أكثر من عناصر إرسال الطالب |
|
الحصول على تسليم للطالب نيابة عن الطالب الذي يملكه. |
|
يتم إرسال المهام التي أرسلها الطلاب. |
|
تسليم تسليم الطالب. |