Method: courses.courseWork.studentSubmissions.list

عرض قائمة بعمليات إرسال الطلاب التي يُسمح لمقدِّم الطلب بالاطّلاع عليها، مع مراعاة نطاقات OAuth للطلب قد يتم تحديد - على أنّه courseWorkId لتضمين عمليات إرسال الطلاب لعناصر متعددة من مهام الدورة التدريبية.

ويمكن لطلاب الدورة التدريبية عرض أعمالهم فقط. يمكن لمعلّمي الدورة التدريبية ومشرفي النطاقات عرض جميع المهام التي أرسلها الطلاب.

تُرجع هذه الطريقة رموز الخطأ التالية:

  • PERMISSION_DENIED إذا لم يتم السماح للمستخدم الذي قدّم الطلب بالوصول إلى الدورة التدريبية أو أعمال الدورة التدريبية المطلوبة، أو بسبب أخطاء الوصول.
  • INVALID_ARGUMENT إذا كان الطلب غير صحيح.
  • NOT_FOUND إذا لم تكن الدورة التدريبية المطلوبة متوفّرة.

طلب HTTP

GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
courseId

string

تمثّل هذه السمة معرّف الدورة التدريبية. يمكن أن يكون هذا المعرّف إما المعرّف الذي حدّده Classroom أو المعرّف alias.
courseWorkId

string

معرّف عمل الطالب المطلوب طلبه ويمكن ضبط هذه السمة على السلسلة الحرفية "-" لطلب عمل الطالب لجميع أعمال الدورة التدريبية في الدورة التدريبية المحدّدة.

معامِلات طلب البحث

المعلمات
userId

string

وسيطة اختيارية لقصر عمل الطالب الذي يتم إرجاعه على الأعمال التي يملكها الطالب باستخدام المعرّف المحدّد يمكن أن يكون المعرّف واحدًا مما يلي:

  • المعرّف الرقمي للمستخدم
  • عنوان البريد الإلكتروني للمستخدم
  • السلسلة الحرفية "me"، للإشارة إلى المستخدم صاحب الطلب
states[]

enum (SubmissionState)

حالات الإرسال المطلوبة تتطابق المهام المرسَلة من الطلاب التي تم إرجاعها مع إحدى حالات الإرسال المحدّدة، إذا تم تحديد ذلك.
late

enum (LateValues)

قيمة التأخر المطلوبة. في حال تحديد هذه السمة، يتم فرض قيود على عمليات إرسال الطلاب التي تم إرجاعها وفقًا للقيمة المطلوبة. في حال عدم تحديد هذه القيم، يتم عرض عمليات الإرسال بغض النظر عن قيمة late.
pageSize

integer

الحدّ الأقصى لعدد السلع المطلوب إرجاعها يشير "صفر" أو "غير محدَّد" إلى أنّ الخادم قد يعيّن حدًا أقصى.

قد يعرض الخادم عددًا أقل من العدد المحدّد من النتائج.
pageToken

string

قيمة nextPageToken التي تم عرضها من طلب list سابق، للإشارة إلى أنه يجب عرض صفحة النتائج اللاحقة.

يجب أن يكون طلب list مطابقًا للطلب الذي نتج عنه هذا الرمز المميّز.
previewVersion

enum (PreviewVersion)

اختياريّ. إصدار المعاينة من واجهة برمجة التطبيقات. ويجب ضبط هذا الخيار للوصول إلى إمكانات واجهة برمجة التطبيقات الجديدة المتوفّرة للمطوّرين في "برنامج المعاينة".

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

الرد عند إدراج المهام التي أرسلها الطالب

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "studentSubmissions": [
    {
      object (StudentSubmission)
    }
  ],
  "nextPageToken": string
}
الحقول
studentSubmissions[]

object (StudentSubmission)

عمل الطالب الذي يتطابق مع الطلب
nextPageToken

string

رمز مميز يحدد الصفحة التالية من النتائج المطلوب عرضها. إذا كان هذا الحقل فارغًا، لن تتوفّر أي نتائج أخرى.

نطاقات الأذونات

يتطلب هذا الإعداد أحد نطاقات 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 يمكنك عرض عمليات إرسال الطلاب في حال كان التأخّر صحيحًا.
NOT_LATE_ONLY يمكنك عرض عمليات إرسال الطلاب إذا كان التأخّر مفعلاً.