Method: courses.courseWork.patch

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

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

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

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

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

درخواست HTTP

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

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

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

پارامترها
courseId

string

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

id

string

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

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

پارامترها
updateMask

string ( FieldMask format)

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

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

  • title
  • description
  • state
  • dueDate
  • dueTime
  • maxPoints
  • scheduledTime
  • submissionModificationMode
  • topicId
  • gradingPeriodId
  • learningGoals

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

previewVersion

enum ( PreviewVersion )

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

درخواست بدنه

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

بدنه پاسخ

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

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

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

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

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