छात्र-छात्राओं के ग्रुप बनाना और उन्हें मैनेज करना

इस प्रोग्राम के तहत, कुछ सुविधाओं को रिलीज़ होने से पहले इस्तेमाल करने का ऐक्सेस मिलता है.

छात्र-छात्राओं के ग्रुप बनाकर, उन्हें अलग-अलग टीमों में व्यवस्थित तरीके से बांटा जा सकता है. इससे ग्रुप की क्षमता के हिसाब से असाइनमेंट देने और साथ मिलकर की जाने वाली गतिविधियों में उनकी भागेदारी तय करने जैसे मकसद पूरे किए जा सकते हैं. Classroom API का इस्तेमाल करके, एडमिन और शिक्षकों की ओर से किसी कोर्स में छात्र-छात्राओं के ग्रुप बनाए जा सकते हैं, उनमें बदलाव किया जा सकता है, और उन्हें पढ़ा जा सकता है.

छात्र-छात्राओं के ग्रुप बनाने, अपडेट करने, मिटाने, और पढ़ने के लिए, इन तरीकों का इस्तेमाल किया जा सकता है:

छात्र-छात्राओं के ग्रुप में सदस्यों को जोड़ने, हटाने, और उन्हें पढ़ने के लिए, यहां दिए गए तरीकों का इस्तेमाल किया जा सकता है:

डेवलपर प्रीव्यू प्रोग्राम में छात्र-छात्राओं के ग्रुप से जुड़े तरीकों को ऐक्सेस करना

छात्र-छात्राओं के ग्रुप बनाने की सुविधा को पूर्वावलोकन के तौर पर ऐक्सेस करने के लिए, आपको यह काम करना होगा:

  • Developer Preview Program (DPP) में शामिल हों.
  • झलक दिखाने वाली सुविधाओं को ऐक्सेस करने के लिए, क्लाइंट लाइब्रेरी सेट अप करें. DPP में मौजूद तरीके, स्टैंडर्ड क्लाइंट लाइब्रेरी और स्टैंडर्ड एचटीटीपी अनुरोधों में नहीं दिखते. डीपीपी में शामिल होने के बाद, कुछ प्रोग्रामिंग भाषाओं के लिए छात्र-छात्राओं के ग्रुप की क्लाइंट लाइब्रेरी को ऐक्सेस और डाउनलोड किया जा सकता है. एपीआई के प्रीव्यू वर्शन को ऐक्सेस करने से जुड़ा पेज देखें. इससे आपको यह जानने में मदद मिलेगी कि प्रीव्यू वर्शन और लेबल के साथ, अपनी पसंद की क्लाइंट लाइब्रेरी कैसे सेट अप करें.
  • एपीआई अनुरोध करते समय, झलक वाला वर्शन और झलक वाला लेबल सेट करें. छात्र-छात्राओं के ग्रुप बनाने के तरीकों के लिए, प्रीव्यू वर्शन V1_20250630_PREVIEW है और प्रीव्यू लेबल DEVELOPER_PREVIEW है. आपको छात्र-छात्राओं के ग्रुप मैनेज करें सेक्शन में, एपीआई के अनुरोधों के उदाहरण मिल सकते हैं. इनमें, झलक वाले वर्शन का इस्तेमाल किया गया है.

लाइसेंस और ज़रूरी शर्तें

किसी कोर्स में छात्र-छात्राओं के ग्रुप बनाने, उनमें बदलाव करने या उन्हें मिटाने के लिए ये शर्तें पूरी होनी चाहिए:

  • अनुरोध करने वाला व्यक्ति, कोर्स का शिक्षक या डोमेन का एडमिन होना चाहिए.
  • अनुरोध करने वाले उपयोगकर्ता के पास, Google Workspace for Education Plus का लाइसेंस होना चाहिए.
  • कोर्स के मालिक को Google Workspace for Education Plus का लाइसेंस असाइन किया गया हो.

छात्र-छात्राओं के ग्रुप और उनके सदस्यों की जानकारी फ़ेच की जा रही है

किसी कोर्स के एडमिन और शिक्षक, छात्र-छात्राओं के ग्रुप का डेटा पढ़ सकते हैं. इससे कोई फ़र्क़ नहीं पड़ता कि उन्हें कौनसा लाइसेंस असाइन किया गया है. इसका मतलब है कि किसी कोर्स में एडमिन या शिक्षक की ओर से, ListStudentGroups और ListStudentGroupMembers एंडपॉइंट के लिए अनुरोध किए जा सकते हैं.

कोड के उदाहरण के लिए ज़रूरी शर्तें

इस गाइड में Python में कोड के उदाहरण दिए गए हैं. साथ ही, यह माना गया है कि आपके पास ये चीज़ें हैं:

  • Google Cloud प्रोजेक्ट. Python क्विकस्टार्ट में दिए गए निर्देशों का पालन करके, एक सेट अप किया जा सकता है.
  • आपके प्रोजेक्ट की OAuth सहमति स्क्रीन में ये स्कोप जोड़े गए हैं:
    • https://www.googleapis.com/auth/classroom.rosters
    • https://www.googleapis.com/auth/classroom.rosters.readonly सिर्फ़ पढ़ने वाले एंडपॉइंट के लिए.
  • उस कोर्स का आईडी जिसमें छात्र-छात्राओं के ग्रुप मैनेज किए जाने हैं. कोर्स के मालिक के पास Google Workspace for Education Plus का लाइसेंस होना चाहिए.
  • शिक्षक या एडमिन के क्रेडेंशियल का ऐक्सेस हो. साथ ही, उसके पास Google Workspace for Education Plus का लाइसेंस हो.

अगर आपने शुरुआत में Python की क्विकस्टार्ट गाइड का इस्तेमाल किया था, तो झलक वाले तरीकों को ऐक्सेस करने के लिए, Classroom सेवा में बदलाव करें.

Python

classroom_service = googleapiclient.discovery.build(
    serviceName='classroom',
    version='v1',
    credentials=creds,
    static_discovery=False,
    discoveryServiceUrl='https://classroom.googleapis.com/$discovery/rest?labels=DEVELOPER_PREVIEW&key=API_KEY')

उपयोगकर्ता के लिए ज़रूरी शर्तें देखना

Classroom API, userProfiles.checkUserCapability एंडपॉइंट उपलब्ध कराता है. इससे आपको यह तय करने में मदद मिलती है कि कोई उपयोगकर्ता, छात्र-छात्राओं के ग्रुप बना सकता है या नहीं. साथ ही, यह भी तय करने में मदद मिलती है कि वह ग्रुप और उसके सदस्यों में बदलाव कर सकता है या नहीं.

userProfiles.checkUserCapability एंडपॉइंट सिर्फ़ यह आकलन करता है कि कोई उपयोगकर्ता किसी सुविधा का इस्तेमाल कर सकता है या नहीं. जैसे, छात्र-छात्राओं के ग्रुप में बदलाव करना. इससे कोर्स की भूमिका के बारे में कोई जानकारी नहीं मिलती. उदाहरण के लिए, अगर किसी उपयोगकर्ता के पास CREATE_STUDENT_GROUP की सुविधा है, लेकिन वह कोर्स में छात्र है, तो CreateStudentGroup एंडपॉइंट के लिए किया गया अनुरोध पूरा नहीं होगा.

Python

def check_student_groups_update_capability(classroom_service, course_id):
    """Checks whether a user is able to create and modify student groups in a course."""
    capability = classroom_service.userProfiles().checkUserCapability(
        userId="me", # Can also be set to a different user's email address or ID
        capability="CREATE_STUDENT_GROUP",
        previewVersion="V1_20240930_PREVIEW" # Required while the method is in the DPP.
    ).execute()

    if capability.get("allowed"): # Retrieve the `allowed` boolean from the response.
        print("User is allowed to create and modify student groups.")
    else:
        print("User is not allowed to create and modify student groups.")

छात्र-छात्राओं के ग्रुप मैनेज करना

छात्र-छात्राओं के ग्रुप बनाने के लिए, CreateStudentGroup एंडपॉइंट का इस्तेमाल किया जा सकता है.

Python

def create_student_group(classroom_service, course_id):
    body = {
        "title": "Team Blue"
    }

    response = classroom_service.courses().studentGroups().create(
        courseId=course_id,
        body=body,
        previewVersion="V1_20250630_PREVIEW",
    ).execute()

    print(response)

जवाब में, छात्र-छात्राओं के नए ग्रुप का id, courseId, और title शामिल होता है.

छात्र-छात्राओं के ग्रुप id का इस्तेमाल, किसी छात्र-छात्रा के ग्रुप को अपडेट करने या मिटाने के लिए किया जा सकता है.

Python

def update_student_group(classroom_service, course_id, student_group_id):
    body = {
        "title": "Team Green"
    }

    response = classroom_service.courses().studentGroups().patch(
        courseId=course_id,
        id=student_group_id,
        body=body,
        updateMask="title",
        previewVersion="V1_20250630_PREVIEW"
    ).execute()

    print(response)

def delete_student_group(classroom_service, course_id, student_group_id):
    response = classroom_service.courses().studentGroups().delete(
        courseId=course_id,
        id=student_group_id,
        previewVersion="V1_20250630_PREVIEW",
    ).execute()

    print(response)

ListStudentGroups एंडपॉइंट का इस्तेमाल करके, किसी कोर्स में मौजूद छात्र-छात्राओं के ग्रुप को वापस लाया जा सकता है:

Python

def list_student_groups(classroom_service, course_id):
    results = classroom_service.courses().studentGroups().list(
        courseId=course_id,
        previewVersion="V1_20250630_PREVIEW"
    ).execute()

    studentGroups = results.get("studentGroups")

छात्र-छात्राओं के ग्रुप के सदस्यों को मैनेज करना

छात्र-छात्राओं का ग्रुप बन जाने के बाद, उसमें सदस्यों को जोड़ा जा सकता है.

Python

def add_student_group_member(classroom_service, course_id, student_group_id):
    body = {
        "userId": "student@schooldomain.com"
    }

    response = classroom_service.courses().studentGroups().studentGroupMembers().create(
        courseId=course_id,
        studentGroupId=student_group_id,
        body=body,
        previewVersion="V1_20250630_PREVIEW"
    ).execute()

    print(response)

अगर आपको छात्र-छात्राओं के ग्रुप से किसी सदस्य को हटाना है, तो इस तरह का अनुरोध करें:

Python

def delete_student_group_member(classroom_service, course_id, student_group_id):
    response = classroom_service.courses().studentGroups().studentGroupMembers().delete(
        courseId=course_id,
        studentGroupId=student_group_id,
        userId="student@schooldomain.com",
        previewVersion="V1_20250630_PREVIEW"
    ).execute()
    print(response)

किसी ग्रुप में शामिल सदस्यों के बारे में जानने के लिए, यह अनुरोध करें:

Python

def list_student_group_members(classroom_service, course_id, student_group_id):
    results = classroom_service.courses().studentGroups().studentGroupMembers().list(
        courseId=course_id,
        studentGroupId=student_group_id,
        previewVersion="V1_20250630_PREVIEW"
    ).execute()

    print(results.get("studentGroupMembers"))

हर StudentGroupMember संसाधन में, ग्रुप के सदस्य की courseId, studentGroupId, और userId शामिल होती है.

पीछे जाएं
अभिभावक बनाना और उन्हें मैनेज करना