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

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