Method: courses.courseWork.studentSubmissions.modifyAttachments

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

لا يمكن إضافة المرفقات إلا إلى المحتوى الذي يرسله الطلاب والذي ينتمي إلى عناصر عمل الدورة التدريبية التي يكون لها workType‏= ASSIGNMENT.

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

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

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

طلب HTTP

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

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

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

المعلمات
courseId

string

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

string

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

string

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

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "addAttachments": [
    {
      object (Attachment)
    }
  ],
  "previewVersion": enum (PreviewVersion)
}
الحقول
addAttachments[]

object (Attachment)

المرفقات المطلوب إضافتها يجب ألّا يتضمّن المحتوى الذي يرسله الطالب أكثر من 20 مرفقًا.

لا يمكن استخدام مرفقات Form.
previewVersion

enum (PreviewVersion)

اختياريّ. إصدار المعاينة لواجهة برمجة التطبيقات. يجب ضبط هذا الخيار للوصول إلى إمكانات واجهة برمجة التطبيقات الجديدة المتاحة للمطوّرين في "برنامج المعاينة".

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال StudentSubmission.

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

يتطلب أحد نطاقات OAuth التالية:

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

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