Method: courses.courseWork.patch

• طلب HTTP
• مَعلمات المسار
• معامِلات طلب البحث
• نص الطلب
• نص الاستجابة
• نطاقات التفويض
• جرِّبه الآن

تعديل حقل واحد أو أكثر من عمل الدورة التدريبية

راجِع 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 متاح في الإصدار V1_20240401_PREVIEW والإصدارات الأحدث. هذه قائمة مفصولة بفواصل تتضمّن أسماء حقول مؤهَّلة بالكامل. مثال: "user.displayName,photo"
previewVersion	enum (PreviewVersion) اختيارية: إصدار المعاينة لواجهة برمجة التطبيقات. يجب ضبط هذا الخيار للوصول إلى إمكانات واجهة برمجة التطبيقات الجديدة المتاحة للمطوّرين في "برنامج المعاينة".

نص الطلب

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

نص الاستجابة

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

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

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

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

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