Method: courses.courseWork.studentSubmissions.return

تعرض هذه الطريقة عملية إرسال من طالب.

عند إرجاع عمل الطالب، يتم نقل ملكية ملفات 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

معرّف الواجب المُرسَل من الطالب

نص الطلب

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

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيكون نص الاستجابة عبارة عن كائن JSON فارغ.

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

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

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

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