Method: courses.create

• طلب HTTP
• نص الطلب
• نص الاستجابة
• نطاقات التفويض
• جرِّبه الآن

تنشئ هذه الطريقة دورة تدريبية.

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

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