تنشئ دورة تدريبية.
المستخدم المحدّد في ownerId هو مالك الدورة التدريبية التي تم إنشاؤها وتمت إضافته كمعلّم. لا يمكن للمستخدم الذي لا يقدّم طلب الحصول على مشرف إنشاء دورة دراسية إلا بنفسه بصفته المالك. يمكن لمشرفي النطاق إنشاء دورات تدريبية يملكها أي مستخدم في نطاقه.
تعرض هذه الطريقة رموز الخطأ التالية:
PERMISSION_DENIEDإذا لم يكن مسموحًا للمستخدم الذي قدّم الطلب بإنشاء دورات تدريبية أو في حال حدوث أخطاء في الوصول.NOT_FOUNDإذا لم يكن المعلّم الأساسي مستخدمًا صالحًا.FAILED_PRECONDITIONإذا تم إيقاف حساب مالك الدورة الدراسية أو بسبب أخطاء الطلب التالية:- UserCannotOwnCourse
- UserGroupsMembershipLimitReached
ALREADY_EXISTSإذا تم تحديد الاسم المستعار فيidوكان متوفرًا من قبل.
طلب HTTP
POST https://classroom.googleapis.com/v1/courses
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
نص الطلب
يحتوي نص الطلب على مثال Course.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل Course تم إنشاؤه حديثًا.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/classroom.courses
لمزيد من المعلومات، راجِع دليل التفويض.