Method: courses.getGradingPeriodSettings

• طلب HTTP
• مَعلمات المسار
• معامِلات طلب البحث
• نص الطلب
• نص الاستجابة
• نطاقات التفويض

إصدار المطوّر: يتوفّر كجزء من برنامج إصدار المطوّر في Google Workspace، الذي يتيح استخدام ميزات معيّنة قبل إطلاقها. تتوفّر هذه الميزة في الإصدار V1_20240401_PREVIEW والإصدارات الأحدث. اطّلِع على الوصول إلى واجهات برمجة التطبيقات في مرحلة المعاينة للاطّلاع على مزيد من المعلومات.

تعرِض هذه السمة إعدادات فترة وضع الدرجات في دورة تدريبية.

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

• PERMISSION_DENIED إذا لم يكن مسموحًا للمستخدم الذي يقدّم الطلب بالوصول إلى إعدادات فترة وضع العلامات في الدورة التدريبية المطلوبة أو بسبب أخطاء في الوصول.
• NOT_FOUND إذا لم تكن الدورة التدريبية المطلوبة متوفّرة.

طلب HTTP

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

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

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

المعلمات
courseId	string مطلوب. معرّف الدورة التدريبية.

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

المعلمات
previewVersion	enum (PreviewVersion) اختيارية: إصدار المعاينة لواجهة برمجة التطبيقات. يجب ضبط هذا الخيار للوصول إلى إمكانات واجهة برمجة التطبيقات الجديدة المتاحة للمطوّرين في "برنامج المعاينة".

نص الطلب

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

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال GradingPeriodSettings.

نطاقات التفويض

يتطلب أحد نطاقات OAuth التالية:

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

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