Method: courses.studentGroups.delete

تحذف هذه الطريقة مجموعة طلاب.

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

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

طلب HTTP

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

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

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

المعلمات
courseId

string

الحقل مطلوب. المعرّف الخاص بالدورة التدريبية التي تحتوي على مجموعة الطلاب المطلوب حذفها

id

string

الحقل مطلوب. المعرّف الخاص بمجموعة الطلاب المطلوب حذفها.

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

المعلمات
previewVersion

enum (PreviewVersion)

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

نص الطلب

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

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيكون نص الاستجابة عبارة عن كائن JSON فارغ.

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

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

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

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