Method: courses.studentGroups.create

• एचटीटीपी अनुरोध
• पाथ पैरामीटर
• क्वेरी पैरामीटर
• अनुरोध का मुख्य हिस्सा
• जवाब का मुख्य हिस्सा
• अनुमति पाने के लिंक

डेवलपर प्रीव्यू: यह सुविधा, Google Workspace Developer Preview Program के तहत उपलब्ध है. इससे कुछ सुविधाओं को रिलीज़ होने से पहले इस्तेमाल करने का ऐक्सेस मिलता है. यह सुविधा V1_20250630_PREVIEW और इसके बाद के वर्शन में उपलब्ध है. ज़्यादा जानने के लिए, Preview API ऐक्सेस करना लेख पढ़ें.

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

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

• 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

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