- طلب HTTP
- معلمات المسار
- معامِلات طلب البحث
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- LateValues
- جرِّبه الآن
تعرض هذه القائمة قائمة بالإرسالات التي يُسمح لمقدّم الطلب بعرضها، مع تضمين نطاقات OAuth للطلب. يمكن تحديد -
على أنّه courseWorkId
لتضمين مهام الطلاب المُرسَلة لعدّة مهام عمل.
بإمكان طلاب الدورات التدريبية عرض أعمالهم فقط. يستطيع معلّمو الدورة التدريبية ومشرفو النطاقات الاطّلاع على جميع المهام التي أرسلها الطلاب.
تعرض هذه الطريقة رموز الخطأ التالية:
PERMISSION_DENIED
إذا لم يُسمح للمستخدم الذي قدّم الطلب بالوصول إلى الدورة التدريبية المطلوبة أو عمل الدورة الدراسية المطلوب، أو بسبب أخطاء الوصول.INVALID_ARGUMENT
إذا كان الطلب غير صحيحNOT_FOUND
في حال عدم توفُّر الدورة التدريبية المطلوبة.
طلب HTTP
GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions
يستخدم عنوان URL بنية gRPC Transcode.
معلّمات المسار
المعلّمات | |
---|---|
courseId |
رقم تعريف الدورة التدريبية ويمكن أن يكون هذا المعرّف إما معرّفًا تم تعيينه في Classroom أو |
courseWorkId |
معرّف عمل الطالب المطلوب طلبه. يمكن ضبط القيمة على السلسلة الحرفية |
معامِلات طلب البحث
المعلّمات | |
---|---|
userId |
وسيطة اختيارية لحصر أعمال الطلاب التي تم إرجاعها على الطالب الذي يحمل المعرّف المحدّد. يمكن أن يكون المعرِّف واحدًا مما يلي:
|
states[] |
حالات الإرسال المطلوبة في حال تحديد المهام التي أرسلها الطلاب، تتطابق مع إحدى حالات الإرسال المحدّدة. |
late |
قيمة وقت الاستجابة المطلوبة في حال تحديد مهام الطلاب المُرسَلة، يتم حظرها من خلال القيمة المطلوبة. وفي حال عدم تحديدها، سيتم عرض عمليات الإرسال بغض النظر عن قيمة |
pageSize |
الحد الأقصى لعدد السلع التي يمكن إرجاعها. يشير الصفر أو عدم التحديد إلى أنه يمكن للخادم تحديد حد أقصى. يمكن أن يعرض الخادم عددًا أقل من العدد المحدّد من النتائج. |
pageToken |
قيمة ويجب أن يكون طلب |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
يمكنك الردّ عند إدراج المهام المُرسَلة من الطلاب.
تمثيل JSON |
---|
{
"studentSubmissions": [
{
object ( |
الحقول | |
---|---|
studentSubmissions[] |
عمل الطالب المطابِق للطلب |
nextPageToken |
رمز مميز يحدّد الصفحة التالية من النتائج لعرضها وفي حال ترك هذا الحقل فارغًا، لن تتوفّر نتائج إضافية. |
نطاقات الأذونات
يتطلب ذلك أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/classroom.coursework.students.readonly
https://www.googleapis.com/auth/classroom.coursework.me.readonly
https://www.googleapis.com/auth/classroom.coursework.students
https://www.googleapis.com/auth/classroom.coursework.me
لمزيد من المعلومات، اطّلِع على دليل التفويض.
قيم متأخرة
قيود على القيمة المتأخرة للسلع المعروضة.
عمليات التعداد | |
---|---|
LATE_VALUES_UNSPECIFIED |
لم يتم تحديد قيود على إرسال القيم المتأخرة. |
LATE_ONLY |
إرجاع المهام التي يرسلها الطلاب في حال تأخّر تسليمها |
NOT_LATE_ONLY |
عرض عمليات إرسال الطلاب في الحالات المتأخرة |