Method: courses.students.create

تتم إضافة مستخدم كطالب للدورة التدريبية.

يُسمح لمشرفي النطاق بإضافة المستخدمين مباشرةً في نطاقهم كطلاب إلى دورات تدريبية ضمن نطاقهم. يُسمح للطلاب بإضافة أنفسهم إلى دورة تدريبية باستخدام رمز التسجيل.

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

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

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcode.

معلّمات المسار

المعلّمات
courseId

string

رقم تعريف الدورة التدريبية لإنشاء الطالب فيها ويمكن أن يكون هذا المعرّف إما معرّفًا تم تعيينه في Classroom أو alias.

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

المعلّمات
enrollmentCode

string

رمز التسجيل الخاص بالدورة التدريبية لإنشاء الطالب فيه هذا الرمز مطلوب إذا كان userId متوافقًا مع المستخدم الذي قدّم الطلب. قد يتم حذفه إذا كان المستخدم الذي قدّم الطلب لديه أذونات إدارية لإنشاء طلاب لأي مستخدم.

نص الطلب

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

نص الاستجابة

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

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

يتطلب ذلك أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/classroom.rosters
  • https://www.googleapis.com/auth/classroom.profile.emails
  • https://www.googleapis.com/auth/classroom.profile.photos

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