تتوفّر الآن إضافات Google Classroom بشكل عام للمطوّرين. يُرجى الاطّلاع على
مستندات الإضافات للحصول على مزيد من المعلومات.
Method: courses.courseWork.addOnAttachments.studentSubmissions.patch
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعديل البيانات المرتبطة بإرسال مرفق إضافة
يجب أن تكون الإضافة هي المنشئ الأصلي للمرفق وأن يكون للمرفق قيمة maxPoints موجبة.
تُرجع هذه الطريقة رموز الأخطاء التالية:
PERMISSION_DENIED لأخطاء الوصول.INVALID_ARGUMENT إذا كان الطلب غير صالحNOT_FOUND إذا لم يكن أحد الموارد المحدّدة متوفّرًا
طلب HTTP
PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
courseId |
string
مطلوب. معرّف الدورة التدريبية.
|
itemId |
string
معرّف Announcement أو CourseWork أو CourseWorkMaterial الذي تم إرفاق المرفق به هذا الحقل مطلوب، ولكن لم يتم وضع علامة عليه تشير إلى ذلك أثناء نقل البيانات من postId.
|
attachmentId |
string
مطلوب. معرّف المرفق
|
submissionId |
string
مطلوب. معرّف العينة التي أرسلها الطالب
|
مَعلمات طلب البحث
| المعلمات |
postId
(deprecated) |
string
اختياريّ. تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام itemId بدلاً منها.
|
updateMask |
string (FieldMask format)
مطلوب. قناع يحدِّد الحقول التي يجب تعديلها في المرفق يتعذّر إجراء التعديل في حال تحديد حقول غير صالحة. إذا كان الحقل يتيح القيم الفارغة، يمكن محو محتواه من خلال تحديده في قناع التعديل وليس في عنصر AddOnAttachmentStudentSubmission. يمكن للمعلّمين تحديد الحقول التالية:
هذه قائمة مفصولة بفواصل تتضمّن أسماء حقول مؤهَّلة بالكامل. مثال: "user.displayName,photo"
|
نص الطلب
يحتوي نص الطلب على مثال AddOnAttachmentStudentSubmission.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال AddOnAttachmentStudentSubmission.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/classroom.addons.teacher
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Method: courses.courseWork.addOnAttachments.studentSubmissions.patch\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nUpdates data associated with an add-on attachment submission.\n\nRequires the add-on to have been the original creator of the attachment and the attachment to have a positive `maxPoints` value set.\n\nThis method returns the following error codes:\n\n- `PERMISSION_DENIED` for [access errors](/workspace/classroom/reference/Access.Errors).\n- `INVALID_ARGUMENT` if the request is malformed.\n- `NOT_FOUND` if one of the identified resources does not exist.\n\n### HTTP request\n\n`PATCH https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{itemId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `courseId` | `string` Required. Identifier of the course. |\n| `itemId` | `string` Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from postId. |\n| `attachmentId` | `string` Required. Identifier of the attachment. |\n| `submissionId` | `string` Required. Identifier of the student's submission. |\n\n### Query parameters\n\n| Parameters ||\n|---------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `postId` **(deprecated)** | `string` Optional. Deprecated, use `itemId` instead. |\n| `updateMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` format)` Required. Mask that identifies which fields on the attachment to update. The update fails if invalid fields are specified. If a field supports empty values, it can be cleared by specifying it in the update mask and not in the `AddOnAttachmentStudentSubmission` object. The following fields may be specified by teachers: - `pointsEarned` This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n\n### Request body\n\nThe request body contains an instance of [AddOnAttachmentStudentSubmission](/workspace/classroom/reference/rest/v1/courses.courseWork.addOnAttachments.studentSubmissions#AddOnAttachmentStudentSubmission).\n\n### Response body\n\nIf successful, the response body contains an instance of [AddOnAttachmentStudentSubmission](/workspace/classroom/reference/rest/v1/courses.courseWork.addOnAttachments.studentSubmissions#AddOnAttachmentStudentSubmission).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/classroom.addons.teacher`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
