Method: courses.students.create

• طلب HTTP
• مَعلمات المسار
• معامِلات طلب البحث
• نص الطلب
• نص الاستجابة
• نطاقات التفويض
• جرِّبه الآن

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

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

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

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

طلب HTTP

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

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

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

المعلمات
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

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