Method: courses.aliases.delete

يؤدي هذا الإجراء إلى حذف الاسم المستعار لدورة دراسية.

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

  • PERMISSION_DENIED إذا لم يكن مسموحًا للمستخدم الذي قدّم الطلب بإزالة الاسم المستعار أو بسبب أخطاء الوصول.
  • NOT_FOUND إذا لم يكن الاسم المستعار موجودًا.
  • FAILED_PRECONDITION إذا لم يكن الاسم المستعار المطلوب منطقيًا للمستخدم أو الدورة الدراسية التي تقدّم الطلب (على سبيل المثال، إذا كان مستخدم ليس في نطاق يحاول حذف اسم مستعار على مستوى النطاق)

طلب HTTP

DELETE https://classroom.googleapis.com/v1/courses/{courseId}/aliases/{alias}

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

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

المَعلمات
courseId

string

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

alias

string

الاسم المستعار المطلوب حذفه. وقد لا يكون هذا المعرّف هو المعرّف الذي يحدّده تطبيق Classroom.

نص الطلب

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

نص الاستجابة

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

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

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

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

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