Method: courses.teachers.delete

تؤدي هذه العملية إلى إزالة المعلّم المحدّد من الدورة التدريبية المحدّدة.

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

  • PERMISSION_DENIED إذا لم يكن مسموحًا للمستخدم الذي يطلب حذف المعلّمين في هذه الدورة التدريبية أو بسبب أخطاء في الوصول.
  • NOT_FOUND إذا لم يكن لدى أيّ من المعلّمين في هذه الدورة التدريبية المعرّف المطلوب أو إذا لم تكن الدورة التدريبية متوفّرة.
  • FAILED_PRECONDITION إذا كان رقم التعريف المطلوب ينتمي إلى المعلّم الأساسي لهذه الدورة التدريبية.
  • FAILED_PRECONDITION إذا كان رقم التعريف المطلوب ينتمي إلى مالك مجلد الدورة التدريبية على Drive
  • FAILED_PRECONDITION إذا لم تعُد الدورة التدريبية لها مالك نشط

طلب HTTP

DELETE https://classroom.googleapis.com/v1/courses/{courseId}/teachers/{userId}

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

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

المعلمات
courseId

string

معرّف الدورة التدريبية. يمكن أن يكون هذا المعرّف هو المعرّف الذي تحدّده Classroom أو alias.
userId

string

معرّف المعلّم المطلوب حذفه. يمكن أن يكون المعرّف واحدًا مما يلي:

  • المعرّف الرقمي للمستخدم
  • عنوان البريد الإلكتروني للمستخدم
  • السلسلة الحرفية "me" التي تشير إلى المستخدم الذي يقدّم الطلب

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يكون نص الاستجابة هو عنصر JSON فارغ.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/classroom.rosters

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