Method: courses.create

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

المستخدم المحدَّد في ownerId هو مالك الدورة التدريبية التي تم إنشاؤها وتمت إضافتها كمُعلِّم. يمكن للمستخدم الذي قدّم طلبًا بدون إذن إنشاء دورة تدريبية وحده بصفته المالك. يمكن لمشرفي النطاقات إنشاء دورات تدريبية يملكها أي مستخدم داخل نطاقهم.

تعرض هذه الطريقة رموز الخطأ التالية:

  • PERMISSION_DENIED إذا لم يُسمَح للمستخدم الذي قدّم الطلب بإنشاء الدورات التدريبية أو أخطاء الوصول.
  • NOT_FOUND إذا لم يكن المُعلّم الأساسي مستخدمًا صالحًا.
  • FAILED_PRECONDITION إذا تم إيقاف حساب مالك الدورة التدريبية أو بسبب أخطاء الطلب التالية:
    • لا يمكن للمستخدم امتلاك دورة تدريبية
    • تم بلوغ الحد الأقصى لعدد المستخدمين
  • ALREADY_EXISTS إذا تم تحديد عنوان بديل في id وكان متوفّرًا من قبل.

طلب HTTP

POST https://classroom.googleapis.com/v1/courses

يستخدم عنوان URL بنية gRPC Transcode.

نص الطلب

يحتوي نص الطلب على مثال Course.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على نسخة افتراضية تم إنشاؤها حديثًا من Course.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/classroom.courses

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