نشان می دهد که آیا کاربر واجد شرایط به روز رسانی GradingPeriodSettings در یک دوره خاص است یا خیر.
این روش کدهای خطای زیر را برمی گرداند:
-
PERMISSION_DENIED
برای خطاهای دسترسی . - اگر درخواست نادرست باشد
INVALID_ARGUMENT
. - اگر دوره درخواستی وجود نداشته باشد،
NOT_FOUND
.
درخواست HTTP
GET https://classroom.googleapis.com/v1/courses/{courseId}:checkGradingPeriodsSetupEligibility
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های | |
---|---|
courseId | ضروری. شناسه دوره. |
پارامترهای پرس و جو
مولفه های | |
---|---|
previewVersion | اختیاری. نسخه پیش نمایش API. این باید برای دسترسی به قابلیتهای API جدیدی که در برنامه پیشنمایش برای توسعهدهندگان در دسترس است، تنظیم شود. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
اینکه آیا کاربر مجاز به بهروزرسانی GradingPeriodSettings در این دوره است یا خیر.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"courseId": string,
"isGradingPeriodsSetupEligible": boolean,
"previewVersion": enum ( |
زمینه های | |
---|---|
courseId | تغییرناپذیر. شناسه دوره. |
isGradingPeriodsSetupEligible | اینکه آیا کاربر مجاز به به روز رسانی GradingPeriodSettings در این دوره است یا خیر. |
previewVersion | فقط خروجی نسخه پیش نمایش API. این باید برای دسترسی به قابلیتهای API جدیدی که در برنامه پیشنمایش برای توسعهدهندگان در دسترس است، تنظیم شود. |
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/classroom.courses
-
https://www.googleapis.com/auth/classroom.courses.readonly
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.