Method: courses.create

إنشاء دورة تدريبية

المستخدم المحدّد في 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

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.