تنشئ اسمًا مستعارًا لدورة دراسية.
تعرض هذه الطريقة رموز الخطأ التالية:
PERMISSION_DENIED
إذا لم يكن مسموحًا للمستخدم الذي قدّم الطلب بإنشاء العنوان البديل أو في حال حدوث أخطاء في الوصول.NOT_FOUND
إذا لم تكن الدورة الدراسية متوفّرة.ALREADY_EXISTS
إذا كان العنوان البديل متوفّرًا من قبل.FAILED_PRECONDITION
إذا كان العنوان البديل للبريد الإلكتروني المطلوب لا معنى له للمستخدم أو الدورة الدراسية التي تقدّم الطلب (على سبيل المثال، إذا كان مستخدم ليس في نطاق يحاول الوصول إلى اسم مستعار على مستوى النطاق).
طلب HTTP
POST https://classroom.googleapis.com/v1/courses/{courseId}/aliases
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
courseId |
هو معرّف الدورة التدريبية إلى الاسم المستعار. ويمكن أن يكون هذا المعرّف إمّا المعرّف الذي حدّده Classroom أو |
نص الطلب
يحتوي نص الطلب على مثال CourseAlias
.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل CourseAlias
تم إنشاؤه حديثًا.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/classroom.courses
لمزيد من المعلومات، راجِع دليل التفويض.