Method: courses.courseWork.studentSubmissions.modifyAttachments

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

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

يجب أن يتم تقديم هذا الطلب من خلال مشروع وحدة تحكم عميل 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

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