Method: courses.students.create

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

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

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

  • 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

لمزيد من المعلومات، راجِع دليل التفويض.