Method: courses.studentGroups.create

यह किसी कोर्स के लिए छात्र-छात्राओं का ग्रुप बनाता है.

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

  • PERMISSION_DENIED अगर अनुरोध करने वाले उपयोगकर्ता को छात्र-छात्राओं का ग्रुप बनाने की अनुमति नहीं है या ऐक्सेस से जुड़ी गड़बड़ियों के लिए.
  • NOT_FOUND अगर कोर्स मौजूद नहीं है या अनुरोध करने वाले उपयोगकर्ता के पास कोर्स का ऐक्सेस नहीं है.
  • FAILED_PRECONDITION अगर छात्र-छात्राओं का ग्रुप बनाने से, हर कोर्स के लिए छात्र-छात्राओं के ग्रुप की तय सीमा से ज़्यादा ग्रुप बन जाएंगे.

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

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

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

पाथ पैरामीटर

पैरामीटर
courseId

string

ज़रूरी है. कोर्स का आइडेंटिफ़ायर.

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

पैरामीटर
previewVersion

enum (PreviewVersion)

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

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

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

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

अगर एपीआई सही से जुड़ जाता है, तो जवाब के मुख्य हिस्से में StudentGroup का नया इंस्टेंस शामिल किया जाता है.

अनुमति के स्कोप

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

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

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