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

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