افزونه های Google Classroom اکنون به طور کلی در دسترس توسعه دهندگان هستند! لطفاً برای اطلاعات بیشتر به
اسناد افزونه ها مراجعه کنید.
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
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-02-27 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-02-27 بهوقت ساعت هماهنگ جهانی."],[[["Updates a course's grading period settings, requiring eligibility to modify them by both the requesting user and course owner."],["The request must include a field mask to specify which fields of the GradingPeriodSettings are to be updated, potentially adding, deleting, or editing grading periods."],["The API uses a PATCH request to `https://classroom.googleapis.com/v1/courses/{courseId}/gradingPeriodSettings`, where `{courseId}` is replaced with the specific course identifier."],["Potential errors include `PERMISSION_DENIED`, `INVALID_ARGUMENT`, and `NOT_FOUND` based on user permissions, request validity, and course existence."],["Authorization requires the `https://www.googleapis.com/auth/classroom.courses` OAuth scope."]]],[]]