يُسمح لمشرفي النطاق بإضافة المستخدمين مباشرةً داخل نطاقهم كطلاب إلى الدورات التدريبية داخل نطاقهم. يُسمح للطلاب بإضافة أنفسهم إلى دورة تدريبية باستخدام رمز تسجيل.
تعرض هذه الطريقة رموز الخطأ التالية:
PERMISSION_DENIED إذا لم يكن مسموحًا للمستخدم الذي قدّم الطلب بإنشاء طلاب في هذه الدورة الدراسية أو في حال حدوث أخطاء في الوصول.
NOT_FOUND إذا لم يكن رقم تعريف الدورة التدريبية المطلوب متوفّرًا.
FAILED_PRECONDITION إذا تم إيقاف حساب المستخدم المطلوب، وذلك بسبب أخطاء الطلب التالية:
CourseMemberLimitReached
CourseNotModifiable
UserGroupsMembershipLimitReached
InactiveCourseOwner
ALREADY_EXISTS إذا كان المستخدم طالبًا أو معلّمًا في الدورة الدراسية.
طلب HTTP
POST https://classroom.googleapis.com/v1/courses/{courseId}/students
معرّف الدورة التدريبية لإنشاء الطالب فيها. ويمكن أن يكون هذا المعرّف إمّا المعرّف الذي حدّده Classroom أو alias.
معلمات طلب البحث
المَعلمات
enrollmentCode
string
رمز التسجيل الخاص بالدورة التدريبية لإنشاء الطالب فيها. يجب استخدام هذا الرمز إذا كان userId متوافقًا مع المستخدِم الذي قدّم الطلب. وقد يتم حذفه إذا كان المستخدم الذي قدّم الطلب لديه أذونات إدارية لإنشاء طلاب لأي مستخدم.