Method: courses.courseWork.studentSubmissions.return

إرجاع مهام الطلاب التي تم تسليمها

يؤدي إرجاع المهام التي أرسلها الطلاب إلى نقل ملكية ملفات Drive المرفقة إلى الطالب وقد يتم أيضًا تعديل حالة عملية الإرسال. وعلى عكس تطبيق Classroom، لا يؤدي عرض إرسال المهام الدراسية إلى ضبط على الدرجة الأولى على الاسم الدرجات.

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

يجب إجراء هذا الطلب في مشروع Play Console الخاص بمعرّف عميل OAuth المُستخدَم لإنشاء عنصر العمل المقابل للدورة التدريبية.

تعرض هذه الطريقة رموز الخطأ التالية:

  • PERMISSION_DENIED إذا لم يُسمح للمستخدم الذي قدّم الطلب بالوصول إلى الدورة الدراسية المطلوبة أو عمل الدورة الدراسية المطلوب، يُرجى إرجاع العمل الذي أرسله الطالب أو بشأن أخطاء الوصول.
  • INVALID_ARGUMENT إذا كان الطلب غير صحيح
  • NOT_FOUND في حال عدم توفُّر الدورة الدراسية المطلوبة أو عمل الدورة الدراسية أو إرسال الطالب.

طلب HTTP

POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:return

يستخدم عنوان URL بنية gRPC Transcode.

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

المعلّمات
courseId

string

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

courseWorkId

string

رقم تعريف عمل الدورة الدراسية.

id

string

معرّف المَهمّة الدراسية التي أرسلها الطالب

نص الطلب

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

نص الاستجابة

وفي حال نجاح هذا الإجراء، سيكون نص الاستجابة فارغًا.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/classroom.coursework.students

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