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

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