Method: courses.courseWork.studentSubmissions.modifyAttachments

لتعديل مرفقات تسليم الطالب

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

يجب إجراء هذا الطلب من خلال مشروع Play 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

لمزيد من المعلومات، راجِع دليل التفويض.