Method: courses.students.create

उपयोगकर्ता को कोर्स के छात्र के तौर पर जोड़ता है.

डोमेन एडमिन को अपने डोमेन में छात्र-छात्राओं के तौर पर अपने डोमेन में उपयोगकर्ताओं को सीधे जोड़ने की अनुमति है. छात्र-छात्राओं को रजिस्ट्रेशन कोड का इस्तेमाल करके, खुद को कोर्स में जोड़ने की अनुमति है.

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

  • PERMISSION_DENIED, अगर अनुरोध करने वाले उपयोगकर्ता को इस कोर्स में या ऐक्सेस से जुड़ी गड़बड़ियों के लिए, छात्र-छात्राओं को जोड़ने की अनुमति नहीं है.
  • NOT_FOUND, अगर अनुरोध किया गया कोर्स आईडी मौजूद नहीं है.
  • FAILED_PRECONDITION, अगर अनुरोध किए गए उपयोगकर्ता का खाता बंद कर दिया गया है, तो इन अनुरोध की गड़बड़ियों के लिए:
    • CourseMemberLimitReached
    • CourseNotModifiable
    • UserGroupsMembershipLimitReached
    • InactiveCourseOwner
  • ALREADY_EXISTS, अगर उपयोगकर्ता पहले से ही इस कोर्स में छात्र/छात्रा या शिक्षक है.

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

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

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

पाथ के पैरामीटर

पैरामीटर
courseId

string

छात्र/छात्रा को बनाने के लिए कोर्स का आइडेंटिफ़ायर. यह आइडेंटिफ़ायर, Classroom से असाइन किया गया आइडेंटिफ़ायर या alias हो सकता है.

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

पैरामीटर
enrollmentCode

string

छात्र/छात्रा को जोड़ने के लिए कोर्स का रजिस्ट्रेशन कोड. अगर userId, अनुरोध करने वाले उपयोगकर्ता से जुड़ा है, तो इस कोड की ज़रूरत होती है. अगर अनुरोध करने वाले उपयोगकर्ता के पास किसी उपयोगकर्ता के लिए छात्र-छात्राओं की जानकारी जोड़ने की एडमिन अनुमतियां हैं, तो इस कोड को हटाया जा सकता है.

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

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

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

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

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

इनमें से कोई एक OAuth स्कोप ज़रूरी है:

  • https://www.googleapis.com/auth/classroom.rosters
  • https://www.googleapis.com/auth/classroom.profile.emails
  • https://www.googleapis.com/auth/classroom.profile.photos

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