Method: courses.courseWork.studentSubmissions.return

تعرض تسليمًا للطالب.

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

لا يجوز تطبيق هذه الطريقة إلا من قِبَل معلّم الدورة التدريبية الذي يحتوي على العينة التي تم إرسالها المطلوبة من الطالب.

يجب إجراء هذا الطلب من خلال مشروع 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.

مَعلمات المسار

المَعلمات
courseId

string

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

string

تمثّل هذه السمة معرّف عمل الدورة الدراسية.
id

string

معرّف الطلب الذي أرسله الطالب

نص الطلب

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

نص الاستجابة

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

نطاقات التفويض

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

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

لمزيد من المعلومات، راجِع دليل التفويض.