Method: courses.aliases.create

لإنشاء اسم بديل لدورة تدريبية

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

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

طلب HTTP

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

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

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

المعلمات
courseId

string

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

نص الطلب

يحتوي نص الطلب على مثال CourseAlias.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل تم إنشاؤه حديثًا من CourseAlias.

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

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

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

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