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

لمزيد من المعلومات، راجِع دليل التفويض.