Method: courses.courseWork.studentSubmissions.return

• طلب HTTP
• مَعلمات المسار
• نص الطلب
• نص الاستجابة
• نطاقات التفويض
• جرِّبه الآن

تعرِض هذه السمة عملًا أرسله طالب.

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

لا يمكن إلا لمعلّم الدورة التدريبية التي تتضمّن العينة المطلوبة التي أرسلها الطالب استدعاء هذه الطريقة.

يجب تقديم هذا الطلب من خلال مشروع Developer 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

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