تتوفّر الآن إضافات Google Classroom بشكل عام للمطوّرين. يُرجى الاطّلاع على
مستندات الإضافات للحصول على مزيد من المعلومات.
Method: courses.students.delete
لحذف طالب من دورة تدريبية
تُرجع هذه الطريقة رموز الأخطاء التالية:
PERMISSION_DENIED
إذا لم يكن مسموحًا للمستخدم الذي يطلب حذف الطلاب في هذه الدورة التدريبية أو بسبب أخطاء في الوصول.
NOT_FOUND
إذا لم يكن لدى أي طالب في هذه الدورة التدريبية رقم التعريف المطلوب أو إذا لم تكن الدورة التدريبية متوفّرة.
طلب HTTP
DELETE https://classroom.googleapis.com/v1/courses/{courseId}/students/{userId}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات |
courseId |
string
معرّف الدورة التدريبية. يمكن أن يكون هذا المعرّف هو المعرّف الذي تحدّده Classroom أو alias .
|
userId |
string
معرّف الطالب المطلوب حذفه. يمكن أن يكون المعرّف واحدًا مما يلي:
- المعرّف الرقمي للمستخدم
- عنوان البريد الإلكتروني للمستخدم
- السلسلة الحرفية
"me" التي تشير إلى المستخدم الذي يقدّم الطلب
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يكون نص الاستجابة فارغًا.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/classroom.rosters
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-12-05 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-12-05 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Deletes a specified student from a given course using their ID."],["Requires authorization with the `https://www.googleapis.com/auth/classroom.rosters` scope."],["Returns an error if the user lacks permission, the student or course is not found, or there are access issues."],["Uses a DELETE request to the endpoint `https://classroom.googleapis.com/v1/courses/{courseId}/students/{userId}` with course and student IDs as path parameters."],["The request body should be empty, and a successful deletion results in an empty response body."]]],[]]