Method: courses.courseWork.rubrics.patch

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

برای جزئیات بیشتر درباره اینکه کدام فیلدها را می توان به روز کرد، به google.classroom.v1.Rubric مراجعه کنید. پس از شروع درجه‌بندی، قابلیت‌های به‌روزرسانی روبریک محدود می‌شود.

این درخواست باید توسط کنسول Google Cloud شناسه مشتری OAuth که برای ایجاد مورد کار دوره والد استفاده می‌شود، انجام شود.

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

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

درخواست HTTP

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

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

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

مولفه های
courseId

string

ضروری. شناسه دوره

courseWorkId

string

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

id

string

اختیاری. شناسه روبریک.

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

مولفه های
updateMask

string ( FieldMask format)

اختیاری. ماسکی که مشخص می کند کدام فیلدها در روبریک باید به روز شوند. این فیلد برای انجام به روز رسانی لازم است. اگر فیلدهای نامعتبر مشخص شوند، به روز رسانی انجام نمی شود. چندین گزینه برای تعریف معیارهای یک روبریک وجود دارد: sourceSpreadsheetId و لیست criteria . فقط یکی از اینها را می توان در یک زمان برای تعریف یک روبریک استفاده کرد.

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

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

  • criteria
  • sourceSpreadsheetId

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

previewVersion

enum ( PreviewVersion )

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

درخواست بدن

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

بدن پاسخگو

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

محدوده مجوز

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

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

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