Method: courses.courseWork.studentSubmissions.patch

یک یا چند فیلد از فرم ارسالی دانشجو را به‌روزرسانی می‌کند.

برای جزئیات بیشتر در مورد اینکه کدام فیلدها ممکن است به‌روزرسانی شوند و چه کسی می‌تواند آنها را تغییر دهد، به google.classroom.v1.StudentSubmission مراجعه کنید.

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

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

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

درخواست HTTP

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

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

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

پارامترها
courseId

string

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

courseWorkId

string

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

id

string

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

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

پارامترها
updateMask

string ( FieldMask format)

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

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

  • draftGrade
  • assignedGrade

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

previewVersion

enum ( PreviewVersion )

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

درخواست بدنه

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

بدنه پاسخ

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

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

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

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

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