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