Method: courses.topics.create

لإنشاء موضوع

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

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

طلب HTTP

POST https://classroom.googleapis.com/v1/courses/{courseId}/topics

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
courseId

string

معرّف الدورة التدريبية. يمكن أن يكون هذا المعرّف هو المعرّف الذي تحدّده Classroom أو alias.

نص الطلب

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

نص الاستجابة

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

نطاقات التفويض

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

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

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