Method: courses.updateGradingPeriodSettings

تنظیمات دوره نمره دهی یک دوره را به روز می کند.

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

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

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

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

درخواست HTTP

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

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

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

پارامترها
courseId

string

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

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

پارامترها
updateMask

string ( FieldMask format)

ماسکی که مشخص می کند کدام فیلدها در GradingPeriodSettings باید به روز شوند.

لیست GradingPeriodSettings gradingPeriods به طور کامل با دوره های درجه بندی مشخص شده در درخواست به روز رسانی جایگزین می شود. به عنوان مثال:

  • دوره های درجه بندی موجود در لیست بدون شناسه، اضافه شده محسوب می شوند و در صورت درخواست، شناسه جدید اختصاص داده می شود.
  • دوره های درجه بندی که در حال حاضر وجود دارد، اما در درخواست وجود ندارد، حذف تلقی می شود.
  • دوره های درجه بندی با شناسه موجود و داده های اصلاح شده، ویرایش در نظر گرفته می شوند. داده های اصلاح نشده به همین شکل باقی خواهند ماند.
  • دوره های درجه بندی همراه با شناسه ناشناخته منجر به خطا می شود.

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

  • gradingPeriods
  • applyToExistingCoursework

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

previewVersion

enum ( PreviewVersion )

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

درخواست بدن

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

بدن پاسخگو

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

محدوده مجوز

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

  • https://www.googleapis.com/auth/classroom.courses

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