Method: courses.courseWork.patch

تُستخدَم لتعديل حقل واحد أو أكثر من مهام الدورة التدريبية.

يمكنك الانتقال إلى 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

string

تمثّل هذه السمة معرّف الدورة التدريبية. يمكن أن يكون هذا المعرّف إما المعرّف الذي حدّده Classroom أو المعرّف alias.
id

string

تمثّل هذه السمة معرّف عمل الدورة التدريبية.

معلمات طلب البحث

المعلمات
updateMask

string (FieldMask format)

قناع يحدّد الحقول المطلوب تعديلها في الدورة التدريبية هذا الحقل مطلوب لإجراء تعديل. ويتعذّر التعديل في حال تحديد حقول غير صالحة. إذا كان أحد الحقول يتيح القيم الفارغة، يمكن محوه من خلال تحديده في قناع التحديث وليس في عنصر CourseWork. وإذا تم تضمين حقل لا يتيح القيم الفارغة في قناع التحديث، ولم يتم ضبطه في الكائن CourseWork، سيتم عرض خطأ INVALID_ARGUMENT.

يمكن للمعلّمين تحديد الحقول التالية:

  • title
  • description
  • state
  • dueDate
  • dueTime
  • maxPoints
  • scheduledTime
  • submissionModificationMode
  • topicId
  • gradingPeriodId متوفّرة في V1_20240401_PREVIEW والإصدارات الأحدث.

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

enum (PreviewVersion)

اختياريّ. إصدار المعاينة من واجهة برمجة التطبيقات. ويجب ضبط هذا الخيار للوصول إلى إمكانات واجهة برمجة التطبيقات الجديدة المتوفّرة للمطوّرين في "برنامج المعاينة".

نص الطلب

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

نص الاستجابة

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

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

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

  • https://www.googleapis.com/auth/classroom.coursework.students

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