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 Transcode.

معلّمات المسار

المعلّمات
courseId

string

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

courseWorkId

string

رقم تعريف عمل الدورة الدراسية.

id

string

معرّف المَهمّة الدراسية التي أرسلها الطالب

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

المعلّمات
updateMask

string (FieldMask format)

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

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

  • draftGrade
  • assignedGrade

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

نص الطلب

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

نص الاستجابة

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

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

يتطلب ذلك أحد نطاقات OAuth التالية:

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

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