Method: courses.create

कोर्स बनाता है.

ownerId में बताया गया उपयोगकर्ता, बनाए गए कोर्स का मालिक है और उसे शिक्षक के तौर पर जोड़ा गया है. बिना एडमिन अनुरोध करने वाला उपयोगकर्ता, मालिक के तौर पर सिर्फ़ खुद से कोर्स बना सकता है. डोमेन एडमिन अपने डोमेन में किसी भी उपयोगकर्ता के मालिकाना हक वाले कोर्स बना सकते हैं.

इस तरीके से ये गड़बड़ी कोड मिलते हैं:

  • PERMISSION_DENIED, अगर अनुरोध करने वाले उपयोगकर्ता को कोर्स बनाने या ऐक्सेस से जुड़ी गड़बड़ियों के लिए अनुरोध करने की अनुमति नहीं है.
  • अगर मुख्य शिक्षक मान्य उपयोगकर्ता नहीं है, तो NOT_FOUND.
  • FAILED_PRECONDITION, अगर कोर्स के मालिक का खाता बंद कर दिया गया हो या नीचे दी गई अनुरोध से जुड़ी गड़बड़ियों के लिए:
    • UserCannotOwnCourse
    • UserGroupsMembershipLimitReached
  • ALREADY_EXISTS, अगर id में कोई उपनाम पहले से मौजूद है.

एचटीटीपी अनुरोध

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

यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य भाग में Course का उदाहरण है.

जवाब का मुख्य भाग

कामयाब होने पर, रिस्पॉन्स के मुख्य हिस्से में Course का नया इंस्टेंस शामिल किया जाता है.

अनुमति देने के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.