Method: courses.posts.addOnAttachments.studentSubmissions.patch

داده های مرتبط با ارسال پیوست افزودنی را به روز می کند.

نیاز دارد که افزونه خالق اصلی پیوست باشد و پیوست دارای مجموعه مقادیر maxPoints مثبت باشد.

این روش کدهای خطای زیر را برمی گرداند:

  • PERMISSION_DENIED برای خطاهای دسترسی .
  • اگر درخواست نادرست باشد INVALID_ARGUMENT .
  • اگر یکی از منابع شناسایی شده وجود نداشته باشد، NOT_FOUND .

درخواست HTTP

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/posts/{postId}/addOnAttachments/{attachmentId}/studentSubmissions/{submissionId}

URL از دستور GRPC Transcoding استفاده می کند.

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

پارامترها
courseId

string

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

postId
(deprecated)

string

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

attachmentId

string

مورد نیاز. شناسه پیوست

submissionId

string

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

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

پارامترها
itemId

string

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

updateMask

string ( FieldMask format)

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

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

  • pointsEarned

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

درخواست بدن

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

بدن پاسخگو

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

محدوده مجوز

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

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

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