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

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