Method: courses.posts.addOnAttachments.studentSubmissions.patch

تعديل البيانات المرتبطة بإرسال مرفق إضافة

يجب أن تكون الإضافة هي المنشئ الأصلي للمرفق وأن يكون للمرفق قيمة maxPoints موجبة.

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

  • PERMISSION_DENIED لأخطاء الوصول.
  • INVALID_ARGUMENT إذا كان الطلب غير صالح
  • NOT_FOUND إذا لم يكن أحد الموارد المحدّدة متوفّرًا

طلب HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}

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

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

المعلمات
courseId

string

مطلوب. معرّف الدورة التدريبية.
postId
(deprecated)

string

اختيارية: تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام itemId بدلاً منها.
attachmentId

string

مطلوب. معرّف المرفق
submissionId

string

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

مَعلمات طلب البحث

المعلمات
itemId

string

معرّف Announcement أو CourseWork أو CourseWorkMaterial الذي تم إرفاق المرفق به هذا الحقل مطلوب، ولكن لم يتم وضع علامة عليه تشير إلى ذلك أثناء نقل البيانات من postId.
updateMask

string (FieldMask format)

مطلوب. قناع يحدِّد الحقول التي يجب تعديلها في المرفق يتعذّر إجراء التعديل في حال تحديد حقول غير صالحة. إذا كان الحقل يتيح القيم الفارغة، يمكن محو محتواه من خلال تحديده في قناع التعديل وليس في عنصر AddOnAttachmentStudentSubmission.

يمكن للمعلّمين تحديد الحقول التالية:

  • pointsEarned

هذه قائمة مفصولة بفواصل تتضمّن أسماء حقول مؤهَّلة بالكامل. مثال: "user.displayName,photo"

نص الطلب

يحتوي نص الطلب على مثال AddOnAttachmentStudentSubmission.

نص الاستجابة

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

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

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/classroom.addons.teacher

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