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