تُستخدَم لتعديل حقل واحد أو أكثر من مهام الدورة التدريبية.
يمكنك الانتقال إلى google.classroom.v1.CourseWork للحصول على تفاصيل حول الحقول التي قد يتم تعديلها والمستخدمين الذين يمكنهم تغييرها.
يجب أن يتم تقديم هذا الطلب من خلال مشروع وحدة تحكم عميل OAuth المستخدَم لإنشاء عنصر عمل الدورة التدريبية المقابل.
تُرجع هذه الطريقة رموز الخطأ التالية:
PERMISSION_DENIEDإذا لم ينشئ مشروع المطوّر الذي قدّم الطلب العمل المقابل للدورة التدريبية، أو إذا لم يُسمح للمستخدم بإجراء التعديل المطلوب على الطلب الذي أرسله الطالب أو بسبب أخطاء في الوصول.INVALID_ARGUMENTإذا كان الطلب غير صحيح.FAILED_PRECONDITIONإذا سبق أن تم حذف مهام الدورة التدريبية المطلوبة.NOT_FOUNDإذا لم تتوفّر الدورة التدريبية المطلوبة أو العمل المطلوب.
طلب HTTP
PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{id}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات | |
|---|---|
courseId |
تمثّل هذه السمة معرّف الدورة التدريبية. يمكن أن يكون هذا المعرّف إما المعرّف الذي حدّده Classroom أو المعرّف |
id |
تمثّل هذه السمة معرّف عمل الدورة التدريبية. |
معلمات طلب البحث
| المعلمات | |
|---|---|
updateMask |
قناع يحدّد الحقول المطلوب تعديلها في الدورة التدريبية هذا الحقل مطلوب لإجراء تعديل. ويتعذّر التعديل في حال تحديد حقول غير صالحة. إذا كان أحد الحقول يتيح القيم الفارغة، يمكن محوه من خلال تحديده في قناع التحديث وليس في عنصر يمكن للمعلّمين تحديد الحقول التالية:
هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: |
previewVersion |
اختياريّ. إصدار المعاينة من واجهة برمجة التطبيقات. ويجب ضبط هذا الخيار للوصول إلى إمكانات واجهة برمجة التطبيقات الجديدة المتوفّرة للمطوّرين في "برنامج المعاينة". |
نص الطلب
يحتوي نص الطلب على مثال CourseWork.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال CourseWork.
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/classroom.coursework.students
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.