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 هي true
NOT_LATE_ONLY عرض StudentSubmissions حيث تكون قيمة late هي false