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