Method: courses.checkGradingPeriodsSetupEligibility

تعرِض هذه السمة ما إذا كان المستخدِم مؤهَّلاً لتعديل GradingPeriodSettings في دورة تدريبية معيّنة.

تُرجع هذه الطريقة رموز الخطأ التالية:

  • PERMISSION_DENIED بسبب أخطاء الوصول.
  • INVALID_ARGUMENT إذا كان الطلب غير صحيح.
  • NOT_FOUND إذا لم تكن الدورة التدريبية المطلوبة متوفّرة.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
courseId

string

مطلوب. تمثّل هذه السمة معرّف الدورة التدريبية.

معامِلات طلب البحث

المعلمات
previewVersion

enum (PreviewVersion)

اختياريّ. إصدار المعاينة من واجهة برمجة التطبيقات. ويجب ضبط هذا الخيار للوصول إلى إمكانات واجهة برمجة التطبيقات الجديدة المتوفّرة للمطوّرين في "برنامج المعاينة".

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

ما إذا كان مسموحًا للمستخدم بتعديل GradingPeriodSettings في هذه الدورة التدريبية

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "courseId": string,
  "isGradingPeriodsSetupEligible": boolean,
  "previewVersion": enum (PreviewVersion)
}
الحقول
courseId

string

غير قابل للتغيير. تمثّل هذه السمة معرّف الدورة التدريبية.
isGradingPeriodsSetupEligible

boolean

ما إذا كان مسموحًا للمستخدم بتعديل GradingPeriodSettings في هذه الدورة التدريبية
previewVersion

enum (PreviewVersion)

النتائج فقط. إصدار المعاينة من واجهة برمجة التطبيقات. ويجب ضبط هذا الخيار للوصول إلى إمكانات واجهة برمجة التطبيقات الجديدة المتوفّرة للمطوّرين في "برنامج المعاينة".

نطاقات الأذونات

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

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

لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.