Method: courses.courseWork.studentSubmissions.patch

تعديل حقل واحد أو أكثر من حقل الإرسال الذي أرسله الطالب

راجِع google.classroom.v1.StudentSubmission لمعرفة الحقول التي يمكن تعديلها والمستخدمين الذين يمكنهم تغييرها.

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

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