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

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