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

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