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 عرض StudentSubmissions حيث يكون وقت التأخير false.