Method: courses.courseWorkMaterials.patch

تعدّل هذه الطريقة حقلًا واحدًا أو أكثر من حقول مواد الواجب الدراسي.

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

  • PERMISSION_DENIED إذا كان مشروع المطوِّر الذي يطلب الوصول يتضمّن أخطاء في الوصول
  • INVALID_ARGUMENT إذا كانت صياغة الطلب غير صحيحة
  • FAILED_PRECONDITION إذا سبق أن تم حذف المادة المطلوبة من الواجب الدراسي
  • ‫NOT_FOUND إذا لم تكن الدورة التدريبية أو مواد الدورة التدريبية المطلوبة متوفرة

طلب HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWorkMaterials/{id}

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

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

المعلمات
courseId

string

تمثّل هذه السمة معرّف الدورة التدريبية. يمكن أن يكون هذا المعرّف إما المعرّف الذي يحدّده Classroom أو alias.
id

string

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

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

المعلمات
updateMask

string (FieldMask format)

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

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

  • title
  • description
  • state
  • scheduledTime
  • topicId

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

enum (PreviewVersion)

اختياريّ. إصدار المعاينة من نقطة النهاية

يتضمّن PREVIEW_VERSION_9001 إمكانات جديدة: * يمكن إجراء تعديلات على المواد. لتعديل المواد، استخدِم updateMask "materials". ستحلّ قائمة المواد المقدَّمة في العنصر CourseWorkMaterial الخاص بالطلب محلّ القائمة الحالية بالكامل. يمكن محو حقل "المواد" من خلال تحديد "المواد" في قناع التعديل وليس في العنصر CourseWorkMaterial. تعديلات CourseWorkMaterial PUBLISHED غير متاحة حاليًا.

نص الطلب

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

نص الاستجابة

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

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

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

  • https://www.googleapis.com/auth/classroom.courseworkmaterials

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