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 Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
courseId

string

ضروری. شناسه دوره

itemId

string

شناسه اعلامیه، courseWork، یا courseWorkMaterial که پیوست تحت آن پیوست شده است. این فیلد الزامی است، اما زمانی که ما از postId مهاجرت می کنیم، به این صورت علامت گذاری نمی شود.

attachmentId

string

ضروری. شناسه پیوست

submissionId

string

ضروری. شناسه ارسال دانش آموز.

پارامترهای پرس و جو

مولفه های
postId
(deprecated)

string

اختیاری. منسوخ شده است، به جای آن از itemId استفاده کنید.

updateMask

string ( FieldMask format)

ضروری. ماسکی که مشخص می‌کند کدام قسمت‌ها در پیوست به‌روزرسانی شوند. اگر فیلدهای نامعتبر مشخص شوند، به روز رسانی انجام نمی شود. اگر یک فیلد از مقادیر خالی پشتیبانی می کند، می توان آن را با مشخص کردن آن در ماسک به روز رسانی و نه در شی AddOnAttachmentStudentSubmission پاک کرد.

فیلدهای زیر ممکن است توسط معلمان مشخص شود:

  • pointsEarned

این فهرستی از نام‌های فیلدهای کاملاً واجد شرایط با کاما است. مثال: "user.displayName,photo" .

درخواست بدن

بدنه درخواست شامل یک نمونه از AddOnAttachmentStudentSubmission است.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از AddOnAttachmentStudentSubmission است.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/classroom.addons.teacher

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.