Method: courses.courseWorkMaterials.addOnAttachments.patch

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

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

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

  • PERMISSION_DENIED بحثًا عن أخطاء الوصول.
  • INVALID_ARGUMENT إذا كان الطلب مكتوبًا بشكلٍ غير صحيح.
  • NOT_FOUND إذا لم يكن أحد الموارد التي تم تحديدها موجودًا.

طلب HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWorkMaterials/{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

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