Method: courses.courseWork.addOnAttachments.patch

تعديل مرفق إضافة

تتطلّب هذه الحالة أن تكون الإضافة هي صانع المرفق الأصلي.

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

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

طلب HTTP

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

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

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

المعلمات
courseId

string

مطلوب. معرّف الدورة التدريبية.

itemId

string

معرّف المشاركة التي تم إرفاق المرفق بها.

attachmentId

string

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

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

المعلمات
postId

string

مطلوب. معرّف المشاركة التي تم إرفاق المرفق بها.

updateMask

string (FieldMask format)

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

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

  • title
  • teacherViewUri
  • studentViewUri
  • studentWorkReviewUri
  • dueDate
  • dueTime
  • maxPoints

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

نص الطلب

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

نص الاستجابة

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

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

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

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

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