Method: courses.courseWorkMaterials.patch

• طلب HTTP
• مَعلمات المسار
• معامِلات طلب البحث
• نص الطلب
• نص الاستجابة
• نطاقات التفويض
• جرِّبه الآن

تعديل حقل واحد أو أكثر من مواد عمل الدورة التدريبية

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

• 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

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