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 عرض StudentSubmissions حيث يكون الحقل late صحيحًا
NOT_LATE_ONLY عرض StudentSubmissions حيث يكون الحقل late خطأ