Method: courses.checkGradingPeriodsSetupEligibility

نشان می دهد که آیا کاربر واجد شرایط به روز رسانی GradingPeriodSettings در یک دوره خاص است یا خیر.

این روش منسوخ شده است. به جای آن از UserProfiles.checkUserCapability استفاده کنید.

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

  • PERMISSION_DENIED برای خطاهای دسترسی .
  • اگر درخواست نادرست باشد INVALID_ARGUMENT .
  • اگر دوره درخواستی وجود نداشته باشد، NOT_FOUND .

درخواست HTTP

GET https://classroom.googleapis.com/v1/courses/{courseId}:checkGradingPeriodsSetupEligibility

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

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

پارامترها
course Id

string

مورد نیاز. شناسه دوره.

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

پارامترها
preview Version

enum ( PreviewVersion )

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

درخواست بدن

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

بدن پاسخگو

اینکه آیا کاربر مجاز به به‌روزرسانی GradingPeriodSettings در این دوره است یا خیر.

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

نمایندگی JSON 
{
  "courseId": string,
  "isGradingPeriodsSetupEligible": boolean,
  "previewVersion": enum (PreviewVersion)
}
فیلدها
course Id

string

تغییرناپذیر. شناسه دوره.

is Grading Periods Setup Eligible

boolean

اینکه آیا کاربر مجاز به به روز رسانی GradingPeriodSettings در این دوره است یا خیر.

preview Version

enum ( PreviewVersion )

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

محدوده مجوز

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

  • https://www.googleapis.com/auth/classroom.courses
  • https://www.googleapis.com/auth/classroom.courses.readonly

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