Method: courses.courseWork.studentSubmissions.patch

تعدِّل حقلاً واحدًا أو أكثر في العناصر التي أرسلها الطالب.

يمكنك الانتقال إلى google.classroom.v1.StudentSubmission للحصول على تفاصيل عن الحقول التي يمكن تعديلها والأشخاص الذين يمكنهم تغييرها.

يجب إجراء هذا الطلب من خلال مشروع Play Console الخاص بمعرِّف عميل OAuth المُستخدَم لإنشاء عنصر عمل الدورة التدريبية المقابل.

تعرض هذه الطريقة رموز الخطأ التالية:

  • PERMISSION_DENIED إذا لم ينشئ مشروع المطوّر الذي يطلب أعمال الدورة التدريبية المقابلة، أو إذا لم يكن مسموحًا للمستخدم بإجراء التعديل المطلوب على العينة التي تم إرسالها، أو بسبب أخطاء في الوصول.
  • INVALID_ARGUMENT إذا كان الطلب مكتوبًا بشكلٍ غير صحيح.
  • NOT_FOUND إذا لم تتوفر الدورة التدريبية أو عمل الدورة الدراسية أو المهمة التي أرسلها الطالب

طلب HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

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

المَعلمات
courseId

string

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

string

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

string

معرّف الطلب الذي أرسله الطالب

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

المَعلمات
updateMask

string (FieldMask format)

قناع يحدِّد الحقول التي يجب تعديلها في المهام التي أرسلها الطالب هذا الحقل مطلوب لإجراء تعديل. يتعذّر التعديل في حال تحديد حقول غير صالحة.

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

  • draftGrade
  • assignedGrade

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

enum (PreviewVersion)

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

نص الطلب

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

نص الاستجابة

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

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

يتطلب استخدام أحد نطاقات OAuth التالية:

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

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