Method: courses.get

تعرض هذه الطريقة دورة تدريبية.

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

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

طلب HTTP

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

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

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

المعلمات
id

string

معرّف الدورة التدريبية المطلوب عرضها يمكن أن يكون هذا المعرّف إما المعرّف الذي يحدّده Classroom أو alias.

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

المعلمات
previewVersion

enum (PreviewVersion)

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

نص الطلب

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

نص الاستجابة

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

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

يجب توفير أحد نطاقات OAuth التالية:

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

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