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"

نص الطلب

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

نص الاستجابة

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

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

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

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

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