Method: courses.courseWork.addOnAttachments.studentSubmissions.patch

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

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

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

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

طلب HTTP

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

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

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

المعلمات
courseId

string

مطلوب. تمثّل هذه السمة معرّف الدورة التدريبية.
itemId

string

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

string

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

string

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

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

المعلمات
postId
(deprecated)

string

اختياريّ. متوقّفة نهائيًا، واستخدِم itemId بدلاً منها.
updateMask

string (FieldMask format)

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

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

  • pointsEarned

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

نص الطلب

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

نص الاستجابة

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

نطاقات الأذونات

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

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

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