Method: courses.studentGroups.create

تنشئ هذه الطريقة مجموعة طلاب لدورة تدريبية.

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

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

طلب HTTP

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

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

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

المعلمات
courseId

string

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

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

المعلمات
previewVersion

enum (PreviewVersion)

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

نص الطلب

يحتوي نص الطلب على مثال StudentGroup.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال تم إنشاؤه حديثًا StudentGroup.

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

يجب توفير نطاق OAuth التالي:

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

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