- طلب HTTP
- مَعلمات المسار
- معامِلات طلب البحث
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- LateValues
- جرِّبه الآن
تعرض قائمة بعمليات إرسال الطلاب التي يُسمح لمقدّم الطلب بالاطّلاع عليها، مع مراعاة نطاقات OAuth للطلب. يمكن تحديد -
على أنّه courseWorkId
لتضمين المهام المُرسَلة من الطلاب لعناصر عمل الدورة الدراسية المتعددة.
يمكن لطلاب الدورة التدريبية مشاهدة أعمالهم فقط. يمكن لمعلّمي الدورات التدريبية ومشرفي النطاق الاطّلاع على جميع المهام التي أرسلها الطلاب.
تعرض هذه الطريقة رموز الخطأ التالية:
PERMISSION_DENIED
إذا لم يكن مسموحًا للمستخدم الذي قدّم الطلب بالوصول إلى الدورة التدريبية أو عمل الدورة الدراسية المطلوب، أو بسبب أخطاء في الوصول.INVALID_ARGUMENT
إذا كان الطلب مكتوبًا بشكلٍ غير صحيح.NOT_FOUND
إذا لم تكن الدورة التدريبية المطلوبة متوفّرة.
طلب HTTP
GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
courseId |
معرّف الدورة التدريبية. ويمكن أن يكون هذا المعرّف إمّا المعرّف الذي حدّده Classroom أو |
courseWorkId |
معرّف عمل الطالب المطلوب طلبه. يمكن ضبط هذه السمة على السلسلة |
معلمات طلب البحث
المَعلمات | |
---|---|
userId |
وسيطة اختيارية لحصر عمل الطالب الذي تم إرجاعه على الأعمال التي يملكها الطالب باستخدام المعرّف المحدّد يمكن أن يكون المعرّف واحدًا مما يلي:
|
states[] |
حالات الإرسال المطلوبة. في حال تم تحديد المهام التي أرسلها الطلاب، يجب أن تتطابق عمليات الإرسال التي تم إرسالها مع إحدى حالات الإرسال المحددة. |
late |
قيمة التأخير المطلوب. وفي حال تحديد هذه القيم، يتم تقييد عمليات الإرسال التي تم إرجاعها بواسطة الطلاب وفقًا للقيمة المطلوبة. وفي حال عدم تحديد ذلك، يتم إرجاع عمليات الإرسال بغض النظر عن قيمة |
pageSize |
الحدّ الأقصى لعدد السلع المطلوب إرجاعها يشير الخيار "صفر" أو "غير محدّد" إلى أنّ الخادم قد يعيّن حدًّا أقصى. قد يعرض الخادم عددًا أقل من عدد النتائج المحدّد. |
pageToken |
تم عرض قيمة ويجب أن يكون طلب |
previewVersion |
اختياريّ. إصدار المعاينة من واجهة برمجة التطبيقات يجب ضبط هذا الإعداد للوصول إلى إمكانات واجهة برمجة التطبيقات الجديدة المتاحة للمطوّرين في "برنامج المعاينة". |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
الرد عند إدراج عمليات إرسال الطلاب.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل 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
لمزيد من المعلومات، راجِع دليل التفويض.
LateValues
قيود مفروضة على القيمة المتأخرة للسلع التي تم إرجاعها
عمليات التعداد | |
---|---|
LATE_VALUES_UNSPECIFIED |
لم يتم تحديد أي قيود على القيم المتأخرة لعمليات الإرسال. |
LATE_ONLY |
يجب عرض StudentSubmissions في الحالات التي يكون فيها التأخير صحيحًا. |
NOT_LATE_ONLY |
عرض StudentSubmissions في الحالات التي يكون فيها التأخير خطأ false. |