Method: courses.create

इस कुकी का इस्तेमाल कोर्स बनाने के लिए किया जाता है.

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

यह तरीका, गड़बड़ी के ये कोड दिखाता है:

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

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

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

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

क्वेरी पैरामीटर

पैरामीटर
previewVersion

enum (PreviewVersion)

ज़रूरी नहीं. एपीआई का झलक वाला वर्शन. इसे सेट करना ज़रूरी है, ताकि डेवलपर को Preview Program में उपलब्ध कराई गई नई एपीआई सुविधाओं का ऐक्सेस मिल सके.

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

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

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

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

अनुमति पाने के लिंक

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

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

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