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

معرّف الإشعار أوcourseWork أو الدورة التدريبيةWorkMaterial الذي تم إرفاق المرفق تحته. هذا الحقل مطلوب، ولكن لم يتم وضع علامة عليه على هذا النحو أثناء نقل البيانات من "PostId" (معرّف المشاركة).
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

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