Method: courses.courseWork.studentSubmissions.modifyAttachments

پیوست‌های ارسالی دانشجویان را اصلاح می‌کند.

پیوست‌ها را فقط می‌توان به مطالب ارسالی دانشجویان که مربوط به موضوعات کار درسی با workType ASSIGNMENT هستند، اضافه کرد.

این درخواست باید توسط پروژه کنسول توسعه‌دهندگانِ شناسه کلاینت OAuth که برای ایجاد آیتم کار درسی مربوطه یا یک پیوست افزونه روی آیتم کار درسی مربوطه استفاده می‌شود، انجام شود.

این متد کدهای خطای زیر را برمی‌گرداند:

  • اگر کاربر درخواست‌کننده اجازه دسترسی به درس یا کار درسی درخواستی را نداشته باشد، اگر کاربر اجازه تغییر پیوست‌های درخواستی دانشجو را نداشته باشد، یا خطاهای دسترسی رخ داده باشد، PERMISSION_DENIED .
  • اگر درخواست ناقص باشد، INVALID_ARGUMENT .
  • اگر دوره، کار دوره یا ارائه دانشجو درخواستی وجود نداشته باشد، NOT_FOUND .

درخواست HTTP

POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{courseWorkId}/studentSubmissions/{id}:modifyAttachments

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

پارامترها
courseId

string

شناسه دوره. این شناسه می‌تواند شناسه اختصاص داده شده توسط کلاس درس یا یک alias باشد.

courseWorkId

string

شناسه‌ی کار دوره.

id

string

شناسه‌ی ارائه‌ی دانشجو.

درخواست بدنه

بدنه درخواست شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "addAttachments": [
    {
      object (Attachment)
    }
  ],
  "previewVersion": enum (PreviewVersion)
}
فیلدها
addAttachments[]

object ( Attachment )

پیوست‌هایی برای افزودن. یک درخواست دانشجویی نمی‌تواند بیش از ۲۰ پیوست داشته باشد.

پیوست‌های Form پشتیبانی نمی‌شوند.

previewVersion

enum ( PreviewVersion )

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

بدنه پاسخ

در صورت موفقیت، بدنه پاسخ شامل نمونه‌ای از StudentSubmission است.

دامنه‌های مجوز

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

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

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