Method: courses.courseWork.studentSubmissions.reclaim

استرداد محتوى أرسله طالب بالنيابة عن الطالب مالك المحتوى

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

لا يمكن إلا للطالب الذي يملك العينة المطلوبة إرسال طلب باستخدام هذه الطريقة، ولا يمكن إرسال طلب إلا للعينة التي تم إرسالها.

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

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

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

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

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

المعلمات
courseId

string

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

courseWorkId

string

معرّف عمل الدورة الدراسية

id

string

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

نص الطلب

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

نص الاستجابة

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

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

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

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

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