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 Transcode.

معلّمات المسار

المعلّمات
courseId

string

رقم تعريف الدورة التدريبية ويمكن أن يكون هذا المعرّف إما معرّفًا تم تعيينه في Classroom أو alias.

courseWorkId

string

معرّف عمل الطالب المطلوب طلبه. يمكن ضبط القيمة على السلسلة الحرفية "-" لطلب عمل الطالب لكل أعمال الدورة الدراسية في الدورة الدراسية المحدّدة.

معامِلات طلب البحث

المعلّمات
userId

string

وسيطة اختيارية لحصر أعمال الطلاب التي تم إرجاعها على الطالب الذي يحمل المعرّف المحدّد. يمكن أن يكون المعرِّف واحدًا مما يلي:

  • المعرّف الرقمي للمستخدم
  • عنوان البريد الإلكتروني للمستخدم
  • السلسلة الحرفية "me"، مع الإشارة إلى المستخدم الذي قدّم الطلب
states[]

enum (SubmissionState)

حالات الإرسال المطلوبة في حال تحديد المهام التي أرسلها الطلاب، تتطابق مع إحدى حالات الإرسال المحدّدة.

late

enum (LateValues)

قيمة وقت الاستجابة المطلوبة في حال تحديد مهام الطلاب المُرسَلة، يتم حظرها من خلال القيمة المطلوبة. وفي حال عدم تحديدها، سيتم عرض عمليات الإرسال بغض النظر عن قيمة late.

pageSize

integer

الحد الأقصى لعدد السلع التي يمكن إرجاعها. يشير الصفر أو عدم التحديد إلى أنه يمكن للخادم تحديد حد أقصى.

يمكن أن يعرض الخادم عددًا أقل من العدد المحدّد من النتائج.

pageToken

string

قيمة nextPageToken التي تم عرضها من مكالمة list سابقة، ما يشير إلى ضرورة عرض الصفحة التالية من النتائج.

ويجب أن يكون طلب list متطابقًا تمامًا مع الطلب الذي أدى إلى إنشاء هذا الرمز المميّز.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

يمكنك الردّ عند إدراج المهام المُرسَلة من الطلاب.

تمثيل 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

لمزيد من المعلومات، اطّلِع على دليل التفويض.

قيم متأخرة

قيود على القيمة المتأخرة للسلع المعروضة.

عمليات التعداد
LATE_VALUES_UNSPECIFIED لم يتم تحديد قيود على إرسال القيم المتأخرة.
LATE_ONLY إرجاع المهام التي يرسلها الطلاب في حال تأخّر تسليمها
NOT_LATE_ONLY عرض عمليات إرسال الطلاب في الحالات المتأخرة