تتم إضافة مستخدم كطالب للدورة التدريبية.
يُسمح لمشرفي النطاق بإضافة المستخدمين مباشرةً في نطاقهم كطلاب إلى دورات تدريبية ضمن نطاقهم. يُسمح للطلاب بإضافة أنفسهم إلى دورة تدريبية باستخدام رمز التسجيل.
تعرض هذه الطريقة رموز الخطأ التالية:
PERMISSION_DENIED
إذا لم يُسمَح للمستخدم الذي قدّم الطلب بإنشاء الطلاب في هذه الدورة التدريبية أو بسبب أخطاء الوصول.NOT_FOUND
في حال عدم توفّر رقم تعريف الدورة التدريبية المطلوبFAILED_PRECONDITION
في حال إيقاف حساب المستخدم المطلوب، بسبب أخطاء الطلب التالية:- تم بلوغ الحدّ الأقصى لعدد المشتركين في الدورة التدريبية
- دورة تدريبية غير مُتاحة
- تم بلوغ الحد الأقصى لعدد المستخدمين
- مالك الدورة التدريبية غير النشطة
ALREADY_EXISTS
إذا كان المستخدم طالبًا أو معلّمًا في الدورة التدريبية
طلب HTTP
POST https://classroom.googleapis.com/v1/courses/{courseId}/students
يستخدم عنوان URL بنية gRPC Transcode.
معلّمات المسار
المعلّمات | |
---|---|
courseId |
رقم تعريف الدورة التدريبية لإنشاء الطالب فيها ويمكن أن يكون هذا المعرّف إما معرّفًا تم تعيينه في Classroom أو |
معامِلات طلب البحث
المعلّمات | |
---|---|
enrollmentCode |
رمز التسجيل الخاص بالدورة التدريبية لإنشاء الطالب فيه هذا الرمز مطلوب إذا كان |
نص الطلب
يحتوي نص الطلب على مثال 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
لمزيد من المعلومات، اطّلِع على دليل التفويض.