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

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

نص الطلب

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

نص الاستجابة

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

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

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

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

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