Method: courses.courseWork.patch

تُعدِّل حقلاً واحدًا أو أكثر من عمل الدورة الدراسية.

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

مَعلمات المسار

المَعلمات
courseId

string

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

string

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

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

المَعلمات
updateMask

string (FieldMask format)

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

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

  • title
  • description
  • state
  • dueDate
  • dueTime
  • maxPoints
  • scheduledTime
  • submissionModificationMode
  • topicId

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

نص الطلب

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

نص الاستجابة

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

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

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

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

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