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 خطأ