Method: courses.courseWork.patch

يعدِّل هذا الطلب حقلًا واحدًا أو أكثر من حقول عمل الدورة الدراسية.

يمكنك الاطّلاع على google.classroom.v1.CourseWork لمعرفة تفاصيل الحقول التي يمكن تعديلها والمستخدمين الذين يمكنهم تغييرها.

يجب أن يتم تقديم هذا الطلب من خلال مشروع Developer 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
  • gradingPeriodId
  • learningGoals

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

enum (PreviewVersion)

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

نص الطلب

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

نص الاستجابة

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

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

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

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

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