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
  • learningGoals

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

enum (PreviewVersion)

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

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

نص الطلب

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

نص الاستجابة

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

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

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

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

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