برای جزئیات بیشتر درباره اینکه کدام فیلدها را می توان به روز کرد، به google.classroom.v1.Rubric مراجعه کنید. پس از شروع درجهبندی، قابلیتهای بهروزرسانی روبریک محدود میشود.
این درخواست باید توسط کنسول Google Cloud شناسه مشتری OAuth که برای ایجاد مورد کار دوره والد استفاده میشود، انجام شود.
این روش کدهای خطای زیر را برمی گرداند:
اگر پروژه برنامهنویس درخواستکننده کار دوره مربوطه را ایجاد نکرده باشد، اگر کاربر مجاز به انجام اصلاحات درخواستی در روبریک نباشد، یا برای خطاهای دسترسی ، PERMISSION_DENIED . این کد خطا نیز برگردانده می شود اگر درجه بندی قبلاً در روبریک شروع شده باشد.
INVALID_ARGUMENT اگر درخواست نادرست باشد و برای خطای درخواست زیر:
RubricCriteriaInvalidFormat
NOT_FOUND اگر دوره، کار دوره یا عنوان درخواستی وجود نداشته باشد یا اگر کاربر به کار دوره مربوطه دسترسی نداشته باشد.
INTERNAL اگر درجه بندی قبلاً در روبریک شروع شده باشد.
اختیاری. ماسکی که مشخص می کند کدام فیلدها در روبریک باید به روز شوند. این فیلد برای انجام به روز رسانی لازم است. اگر فیلدهای نامعتبر مشخص شوند، به روز رسانی انجام نمی شود. چندین گزینه برای تعریف معیارهای یک روبریک وجود دارد: sourceSpreadsheetId و لیست criteria . فقط یکی از اینها را می توان در یک زمان برای تعریف یک روبریک استفاده کرد.
لیست criteria روبریک به طور کامل با معیارهای روبری مشخص شده در درخواست به روز رسانی جایگزین می شود. به عنوان مثال، اگر معیار یا سطحی در درخواست وجود نداشته باشد، حذف می شود. معیارها و سطوح جدید اضافه شده و شناسه اختصاص داده می شود. در صورتی که شناسه در درخواست مشخص شده باشد، معیارها و سطوح موجود، شناسه اختصاص داده شده قبلی را حفظ می کنند.
فیلدهای زیر را می توان توسط معلمان مشخص کرد:
criteria
sourceSpreadsheetId
این فهرستی از نامهای فیلدهای کاملاً واجد شرایط با کاما است. مثال: "user.displayName,photo" .