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

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