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

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