ছাত্র গোষ্ঠী তৈরি এবং পরিচালনা করুন

আপনি ছাত্র গোষ্ঠী ব্যবহার করে শিক্ষার্থীদের নির্দিষ্ট গোষ্ঠীতে সংগঠিত করতে পারেন যাতে তারা উন্নত শিক্ষাদানের অভিজ্ঞতা অর্জন করতে পারে, যেমন লক্ষ্যবস্তু অ্যাসাইনমেন্ট এবং সহযোগী কার্যকলাপ। প্রশাসক এবং শিক্ষকদের পক্ষ থেকে একটি কোর্সের মধ্যে ছাত্র গোষ্ঠী তৈরি, সংশোধন এবং পড়ার জন্য Classroom API ব্যবহার করুন।

আপনি নিম্নলিখিত পদ্ধতিগুলি ব্যবহার করে ছাত্র গোষ্ঠী তৈরি করতে, আপডেট করতে, মুছে ফেলতে এবং পড়তে পারেন:

আপনি নিম্নলিখিত পদ্ধতিগুলি ব্যবহার করে একটি ছাত্র গোষ্ঠীর মধ্যে সদস্যদের যোগ করতে, অপসারণ করতে এবং পড়তে পারেন:

লাইসেন্সিং এবং যোগ্যতার প্রয়োজনীয়তা

একটি কোর্সে ছাত্র গোষ্ঠী তৈরি, পরিবর্তন বা মুছে ফেলার জন্য এবং ছাত্র গোষ্ঠী থেকে সদস্যদের যোগ বা অপসারণের জন্য, নিম্নলিখিত শর্তগুলি পূরণ করতে হবে:

  • অনুরোধকারী ব্যবহারকারীকে অবশ্যই কোর্সের একজন শিক্ষক অথবা ডোমেনের প্রশাসক হতে হবে।
  • অনুরোধকারী ব্যবহারকারীর কাছে অবশ্যই একটি Google Workspace for Education Plus লাইসেন্স থাকতে হবে।
  • কোর্সের মালিকের কাছে অবশ্যই একটি Google Workspace for Education Plus লাইসেন্স থাকতে হবে।

পঠন ছাত্র দল এবং এর সদস্যরা

কোনও কোর্সের প্রশাসক এবং শিক্ষকরা যে লাইসেন্সই বরাদ্দ করা হোক না কেন, শিক্ষার্থী গোষ্ঠীর ডেটা পড়তে পারেন। এর অর্থ হল, কোনও কোর্সের যেকোনো প্রশাসক বা শিক্ষকের পক্ষ থেকে ListStudentGroups এবং ListStudentGroupMembers এন্ডপয়েন্টগুলিতে অনুরোধ করা অনুমোদিত।

কোড উদাহরণের পূর্বশর্ত

এই নির্দেশিকাটি পাইথনে কোডের উদাহরণ প্রদান করে এবং ধরে নেয় যে আপনার কাছে নিম্নলিখিতগুলি আছে:

  • একটি গুগল ক্লাউড প্রকল্প। আপনি পাইথন কুইকস্টার্টের নির্দেশাবলী অনুসরণ করে একটি সেট আপ করতে পারেন।
  • আপনার প্রোজেক্টের 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 লাইসেন্সের মাধ্যমে একজন শিক্ষক বা প্রশাসকের শংসাপত্র অ্যাক্সেস করুন।

ব্যবহারকারীর যোগ্যতা পরীক্ষা করুন

Classroom API userProfiles.checkUserCapability এন্ডপয়েন্ট প্রদান করে যা আপনাকে সক্রিয়ভাবে নির্ধারণ করতে সাহায্য করে যে একজন ব্যবহারকারী ছাত্র গোষ্ঠী এবং এর সদস্যদের তৈরি এবং পরিবর্তন করতে সক্ষম কিনা। এই পদ্ধতিটি ডেভেলপার প্রিভিউ প্রোগ্রামের মাধ্যমে উপলব্ধ। যদি আপনি Python quickstart কে একটি সূচনা বিন্দু হিসাবে অনুসরণ করে থাকেন, তাহলে একটি নতুন Classroom পরিষেবা সেট আপ করুন যা প্রিভিউ পদ্ধতিগুলি অ্যাক্সেস করতে পারে:

পাইথন 

classroom_service_with_capability_endpoint = 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')

userProfiles.checkUserCapability এন্ডপয়েন্ট শুধুমাত্র মূল্যায়ন করে যে একজন ব্যবহারকারী কোন নির্দিষ্ট ক্ষমতা ব্যবহার করার জন্য যোগ্য কিনা, যেমন ছাত্র গোষ্ঠী পরিবর্তন করা। এটি কোর্সের ভূমিকা সম্পর্কে কোনও তথ্য প্রদান করে না। উদাহরণস্বরূপ, যদি একজন ব্যবহারকারীর CREATE_STUDENT_GROUP ক্ষমতা থাকে, তবে যদি তারা কোর্সের একজন ছাত্র হয়, তাহলে CreateStudentGroup এন্ডপয়েন্টে অনুরোধ করা সফল হবে না।

পাইথন 

def check_student_groups_update_capability():
    """Checks whether a user is eligible to create and modify student groups."""
    capability = classroom_service_with_capability_endpoint.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 eligible to create and modify student groups.")
    else:
        print("User is not eligible to create and modify student groups.")

ছাত্র গোষ্ঠী পরিচালনা করুন

CreateStudentGroup এন্ডপয়েন্ট ব্যবহার করে ছাত্র গোষ্ঠী তৈরি করা যেতে পারে।

পাইথন 

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

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

    print(response)

উত্তরে নতুন তৈরি ছাত্র গোষ্ঠীর id , courseId এবং ছাত্র গোষ্ঠীর title থাকবে।

স্টুডেন্ট গ্রুপ id ব্যবহার করে স্টুডেন্ট গ্রুপ আপডেট বা ডিলিট করা যাবে।

পাইথন 

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"
    ).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
    ).execute()

    print(response)

আপনি ListStudentGroups এন্ডপয়েন্ট ব্যবহার করে একটি কোর্সের মধ্যে ছাত্র গোষ্ঠীগুলি পুনরুদ্ধার করতে পারেন:

পাইথন 

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

    studentGroups = results.get("studentGroups")

ছাত্র দলের সদস্যদের পরিচালনা করুন

ছাত্র গোষ্ঠীটি সফলভাবে তৈরি হয়ে গেলে, আপনি এতে সদস্য যোগ করতে পারেন।

পাইথন 

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
    ).execute()

    print(response)

যদি আপনি কোন ছাত্র গোষ্ঠী থেকে কোন সদস্যকে অপসারণ করতে চান, তাহলে নিম্নলিখিতভাবে একটি অনুরোধ করুন:

পাইথন 

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"
    ).execute()
    print(response)

আপনি নিম্নলিখিত অনুরোধ করে একটি গ্রুপের সদস্যদের পড়তে পারেন:

পাইথন 

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
    ).execute()

    print(results.get("studentGroupMembers"))

প্রতিটি StudentGroupMember রিসোর্সে গ্রুপ সদস্যের courseId , studentGroupId এবং userId অন্তর্ভুক্ত থাকে।

পূর্ববর্তী
অভিভাবক তৈরি করুন এবং পরিচালনা করুন