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 في الحالات التي يكون فيها التأخير صحيحًا.
NOT_LATE_ONLY عرض StudentSubmissions في الحالات التي يكون فيها التأخير خطأ false.