يُسمح لمشرفي النطاق بإضافة المستخدمين مباشرةً داخل نطاقهم كطلاب إلى الدورات التدريبية داخل نطاقهم. يُسمح للطلاب بإضافة أنفسهم إلى دورة تدريبية باستخدام رمز تسجيل.
تعرض هذه الطريقة رموز الخطأ التالية:
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 متوافقًا مع المستخدِم الذي قدّم الطلب. وقد يتم حذفه إذا كان المستخدم الذي قدّم الطلب لديه أذونات إدارية لإنشاء طلاب لأي مستخدم.
تاريخ التعديل الأخير: 2024-09-05 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-09-05 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Adds a user as a student to a specified course using the Classroom API."],["Allows domain administrators to directly add users as students or students to self-enroll with an enrollment code."],["Returns a Student object upon successful creation or various error codes if unsuccessful."],["Requires specific authorization scopes for access to Classroom roster and user profile data."],["Provides an HTTP request structure with detailed explanations of path and query parameters, request and response bodies."]]],[]]
