Method: courses.studentGroups.list

تعرض هذه الطريقة قائمة بالمجموعات في إحدى الدورات التدريبية.

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

  • ‫NOT_FOUND إذا لم تكن الدورة التدريبية متوفّرة

طلب HTTP

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

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

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

المعلمات
courseId

string

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

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

المعلمات
pageSize

integer

الحد الأقصى لعدد العناصر المطلوب عرضها. يشير الرقم صفر أو عدم التحديد إلى أنّ الخادم قد يحدّد حدًا أقصى، وهو حاليًا 75 عنصرًا.

قد يعرض الخادم عددًا أقل من النتائج المحدّدة.
pageToken

string

قيمة nextPageToken تم إرجاعها من طلب list سابق، تشير إلى أنّه يجب إرجاع الصفحة التالية من النتائج.

يجب أن يكون طلب list مطابقًا للطلب الذي نتجت عنه الرمز المميّز.
previewVersion

enum (PreviewVersion)

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

نص الطلب

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

نص الاستجابة

الردّ عند إدراج مجموعات الطلاب

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

تمثيل JSON 
{
  "studentGroups": [
    {
      object (StudentGroup)
    }
  ],
  "nextPageToken": string
}
الحقول
studentGroups[]

object (StudentGroup)

مجموعات الطلاب
nextPageToken

string

رمز مميّز يعرّف الصفحة التالية من النتائج التي سيتم عرضها. إذا كانت فارغة، لا تتوفّر نتائج أخرى.

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

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

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

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