Method: courses.studentGroups.studentGroupMembers.create

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

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

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

طلب HTTP

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

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

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

المعلمات
courseId

string

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

string

مطلوب. المعرّف الخاص بمجموعة الطلاب

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

المعلمات
previewVersion

enum (PreviewVersion)

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

نص الطلب

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

نص الاستجابة

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

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

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

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

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