রুব্রিক দিয়ে শুরু করুন

একটি rubric হল একটি টেমপ্লেট যা শিক্ষকরা ছাত্র জমা দেওয়ার সময় গ্রেড করার সময় ব্যবহার করতে পারেন। ক্লাসরুম API আপনাকে এই রুব্রিকগুলি পরিচালনা করতে শিক্ষকের পক্ষে কাজ করতে দেয়।

ক্লাসরুম UI-তে একটি রুব্রিকের দৃশ্য চিত্র 1. ক্লাসরুম অ্যাসাইনমেন্টে একটি নমুনা রুব্রিকের দৃশ্য।

এই নির্দেশিকাটি রুব্রিক্স API-এর মৌলিক ধারণা এবং কার্যকারিতা ব্যাখ্যা করে। রুব্রিকের সাধারণ গঠন এবং ক্লাসরুম UI-তে রুব্রিক গ্রেডিং কীভাবে করা হয় সে সম্পর্কে জানতে এই সহায়তা কেন্দ্র নিবন্ধগুলি দেখুন।

পূর্বশর্ত

এই গাইডটি অনুমান করে যে আপনার নিম্নলিখিতগুলি রয়েছে:

একটি ডেস্কটপ অ্যাপ্লিকেশনের জন্য শংসাপত্র অনুমোদন করুন৷

শেষ ব্যবহারকারী হিসাবে প্রমাণীকরণ করতে এবং আপনার অ্যাপে ব্যবহারকারীর ডেটা অ্যাক্সেস করতে, আপনাকে এক বা একাধিক OAuth 2.0 ক্লায়েন্ট আইডি তৈরি করতে হবে। Google-এর OAuth সার্ভারে একটি একক অ্যাপ শনাক্ত করতে একটি ক্লায়েন্ট আইডি ব্যবহার করা হয়। যদি আপনার অ্যাপ একাধিক প্ল্যাটফর্মে চলে, তাহলে আপনাকে অবশ্যই প্রতিটি প্ল্যাটফর্মের জন্য একটি পৃথক ক্লায়েন্ট আইডি তৈরি করতে হবে।

  1. Google ক্লাউড কনসোলে Google ক্লাউড শংসাপত্র পৃষ্ঠাতে নেভিগেট করুন।
  2. ক্রিয়েট ক্রেডেনশিয়াল > OAuth ক্লায়েন্ট আইডি ক্লিক করুন।
  3. Application type > Desktop app এ ক্লিক করুন।
  4. নাম ক্ষেত্রে, শংসাপত্রের জন্য একটি নাম টাইপ করুন। এই নামটি শুধুমাত্র Google ক্লাউড কনসোলে দেখানো হয়। উদাহরণস্বরূপ, "রুব্রিক্স প্রিভিউ ক্লায়েন্ট"।
  5. তৈরি করুন ক্লিক করুন। OAuth ক্লায়েন্ট তৈরি করা স্ক্রীন প্রদর্শিত হবে, আপনার নতুন ক্লায়েন্ট আইডি এবং ক্লায়েন্টের গোপনীয়তা দেখাচ্ছে।
  6. JSON ডাউনলোড করুন ক্লিক করুন, তারপর ওকে ক্লিক করুন। নতুন তৈরি শংসাপত্রটি OAuth 2.0 ক্লায়েন্ট আইডিগুলির অধীনে প্রদর্শিত হয়৷
  7. ডাউনলোড করা JSON ফাইলটিকে credentials.json হিসাবে সংরক্ষণ করুন এবং ফাইলটিকে আপনার কার্যকারী ডিরেক্টরিতে সরান৷
  8. ক্রিয়েট ক্রেডেনশিয়াল > API কী ক্লিক করুন এবং API কীটি নোট করুন।

আরও জানতে অ্যাক্সেস শংসাপত্র তৈরি করুন দেখুন।

OAuth স্কোপ কনফিগার করুন

আপনার প্রোজেক্টের বিদ্যমান OAuth স্কোপের উপর নির্ভর করে, আপনাকে অতিরিক্ত সুযোগগুলি কনফিগার করতে হতে পারে।

  1. OAuth সম্মতি স্ক্রিনে নেভিগেট করুন।
  2. স্কোপ স্ক্রিনে যেতে অ্যাপ সম্পাদনা করুন > সংরক্ষণ করুন এবং চালিয়ে যান- এ ক্লিক করুন।
  3. স্কোপ যোগ করুন বা সরান ক্লিক করুন।
  4. আপনার যদি ইতিমধ্যেই না থাকে তবে নিম্নলিখিত স্কোপগুলি যোগ করুন:
    • https://www.googleapis.com/auth/classroom.coursework.students
    • https://www.googleapis.com/auth/classroom.courses
  5. তারপর আপডেট > সেভ অ্যান্ড কন্টিনিউ > সেভ অ্যান্ড কন্টিনিউ > ব্যাক টু ড্যাশবোর্ডে ক্লিক করুন।

আরও জানতে OAuth সম্মতি স্ক্রীন কনফিগার করুন দেখুন।

classroom.coursework.students স্কোপ রুব্রিকগুলিতে পড়ার এবং লেখার অ্যাক্সেস সক্ষম করে ( CourseWork অ্যাক্সেস সহ), এবং classroom.courses স্কোপ পাঠ্য এবং লেখার পাঠ্যক্রমকে অনুমতি দেয়৷

প্রদত্ত পদ্ধতির জন্য প্রয়োজনীয় সুযোগগুলি পদ্ধতির জন্য রেফারেন্স ডকুমেন্টেশনে তালিকাভুক্ত করা হয়েছে। উদাহরণ হিসেবে courses.courseWork.rubrics.create অনুমোদনের সুযোগ দেখুন। আপনি Google API-এর জন্য OAuth 2.0 স্কোপে সমস্ত ক্লাসরুম স্কোপ দেখতে পারেন। রুব্রিক্স এখানে উল্লেখ করা হয়নি যেহেতু API এখনও প্রিভিউতে রয়েছে।

নমুনা কনফিগার করুন

আপনার কাজের ডিরেক্টরিতে, পাইথনের জন্য Google ক্লায়েন্ট লাইব্রেরি ইনস্টল করুন:

pip install --upgrade google-api-python-client google-auth-httplib2 google-auth-oauthlib

main.py নামে একটি ফাইল তৈরি করুন যা ক্লায়েন্ট লাইব্রেরি তৈরি করে এবং ব্যবহারকারীকে অনুমোদন করে, YOUR_API_KEY এর জায়গায় আপনার API কী ব্যবহার করে :

import json
import os.path

from google.auth.transport.requests import Request
from google.oauth2.credentials import Credentials
from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError

# If modifying these scopes, delete the file token.json.
SCOPES = ['https://www.googleapis.com/auth/classroom.courses',
          'https://www.googleapis.com/auth/classroom.coursework.students']

def build_authenticated_service(api_key):
    """Builds the Classroom service."""
    creds = None
    # The file token.json stores the user's access and refresh tokens, and is
    # created automatically when the authorization flow completes for the first
    # time.
    if os.path.exists('token.json'):
        creds = Credentials.from_authorized_user_file('token.json', SCOPES)
    # If there are no (valid) credentials available, let the user log in.
    if not creds or not creds.valid:
        if creds and creds.expired and creds.refresh_token:
            creds.refresh(Request())
        else:
            flow = InstalledAppFlow.from_client_secrets_file(
                'credentials.json', SCOPES)
            creds = flow.run_local_server(port=0)
        # Save the credentials for the next run.
        with open('token.json', 'w') as token:
            token.write(creds.to_json())

    try:
        # Build the Classroom service.
        service = build(
            serviceName="classroom",
            version="v1",
            credentials=creds,
            discoveryServiceUrl=f"https://classroom.googleapis.com/$discovery/rest?labels=DEVELOPER_PREVIEW&key={api_key}")

        return service

    except HttpError as error:
        print('An error occurred: %s' % error)

if __name__ == '__main__':
    service = build_authenticated_service(YOUR_API_KEY)

python main.py ব্যবহার করে স্ক্রিপ্টটি চালান। আপনাকে সাইন ইন করতে এবং OAuth স্কোপে সম্মতি দিতে বলা উচিত।

একটি অ্যাসাইনমেন্ট তৈরি করুন

একটি রুব্রিক একটি অ্যাসাইনমেন্ট, বা CourseWork সাথে যুক্ত, এবং শুধুমাত্র সেই CourseWork প্রসঙ্গে অর্থবহ৷ রুব্রিকগুলি শুধুমাত্র Google ক্লাউড প্রকল্প দ্বারা তৈরি করা যেতে পারে যা মূল CourseWork আইটেম তৈরি করেছে৷ এই গাইডের উদ্দেশ্যে, একটি স্ক্রিপ্ট সহ একটি নতুন CourseWork অ্যাসাইনমেন্ট তৈরি করুন৷

main.py তে নিম্নলিখিত যোগ করুন:

def get_latest_course(service):
    """Retrieves the last created course."""
    try:
        response = service.courses().list(pageSize=1).execute()
        courses = response.get("courses", [])
        if not courses:
            print("No courses found. Did you remember to create one in the UI?")
            return
        course = courses[0]
        return course

    except HttpError as error:
        print(f"An error occurred: {error}")
        return error

def create_coursework(service, course_id):
    """Creates and returns a sample coursework."""
    try:
        coursework = {
            "title": "Romeo and Juliet analysis.",
            "description": """Write a paper arguing that Romeo and Juliet were
                                time travelers from the future.""",
            "workType": "ASSIGNMENT",
            "state": "PUBLISHED",
        }
        coursework = service.courses().courseWork().create(
            courseId=course_id, body=coursework).execute()
        return coursework

    except HttpError as error:
        print(f"An error occurred: {error}")
        return error

এখন আপনার তৈরি করা পরীক্ষার ক্লাসের course_id পুনরুদ্ধার করতে, একটি নতুন নমুনা অ্যাসাইনমেন্ট তৈরি করতে এবং অ্যাসাইনমেন্টের coursework_id পুনরুদ্ধার করতে main.py আপডেট করুন :

if __name__ == '__main__':
    service = build_authenticated_service(YOUR_API_KEY)

    course = get_latest_course(service)
    course_id = course.get("id")
    course_name = course.get("name")
    print(f"'{course_name}' course ID: {course_id}")

    coursework = create_coursework(service, course_id)
    coursework_id = coursework.get("id")
    print(f"Assignment created with ID {coursework_id}")

    #TODO(developer): Save the printed course and coursework IDs.

course_id এবং coursework_id সংরক্ষণ করুন। এই সব রুব্রিক CRUD অপারেশন জন্য প্রয়োজন হয়.

আপনার এখন ক্লাসরুমে একটি নমুনা CourseWork থাকা উচিত।

ক্লাসরুম UI-তে একটি অ্যাসাইনমেন্টের দৃশ্য চিত্র 2. ক্লাসরুমে একটি নমুনা অ্যাসাইনমেন্টের দৃশ্য।

একটি রুব্রিক তৈরি করুন

এখন আপনি রুব্রিক পরিচালনা শুরু করতে প্রস্তুত৷

সম্পূর্ণ রুব্রিক অবজেক্ট সম্বলিত একটি Create কল সহ একটি CourseWork একটি রুব্রিক তৈরি করা যেতে পারে, যেখানে মানদণ্ড এবং স্তরগুলির জন্য আইডি বৈশিষ্ট্যগুলি বাদ দেওয়া হয় (এগুলি তৈরির সময় তৈরি করা হয়)৷

main.py এ নিম্নলিখিত ফাংশন যোগ করুন:

def create_rubric(service, course_id, coursework_id):
    """Creates an example rubric on a coursework."""
    try:
        body = {
            "criteria": [
                {
                    "title": "Argument",
                    "description": "How well structured your argument is.",
                    "levels": [
                        {"title": "Convincing",
                         "description": "A compelling case is made.", "points": 30},
                        {"title": "Passable",
                         "description": "Missing some evidence.", "points": 20},
                        {"title": "Needs Work",
                         "description": "Not enough strong evidence..", "points": 0},
                    ]
                },
                {
                    "title": "Spelling",
                    "description": "How well you spelled all the words.",
                    "levels": [
                        {"title": "Perfect",
                         "description": "No mistakes.", "points": 20},
                        {"title": "Great",
                         "description": "A mistake or two.", "points": 15},
                        {"title": "Needs Work",
                         "description": "Many mistakes.", "points": 5},
                    ]
                },
                {
                    "title": "Grammar",
                    "description": "How grammatically correct your sentences are.",
                    "levels": [
                        {"title": "Perfect",
                         "description": "No mistakes.", "points": 20},
                        {"title": "Great",
                         "description": "A mistake or two.", "points": 15},
                        {"title": "Needs Work",
                         "description": "Many mistakes.", "points": 5},
                    ]
                },
            ]
        }

        rubric = service.courses().courseWork().rubrics().create(
            courseId=course_id, courseWorkId=coursework_id, body=body,
            # Specify the preview version. Rubrics CRUD capabilities are
            # supported in V1_20231110_PREVIEW and later.
            previewVersion="V1_20231110_PREVIEW"
            ).execute()
        print(f"Rubric created with ID {rubric.get('id')}")
        return rubric

    except HttpError as error:
        print(f"An error occurred: {error}")
        return error

তারপরে আপনার Course এবং CourseWork আইডি ব্যবহার করে উদাহরণ রুব্রিক তৈরি করতে main.py আপডেট করুন এবং চালান:

if __name__ == '__main__':
    service = build_authenticated_service(YOUR_API_KEY)

    rubric = create_rubric(service, YOUR_COURSE_ID, YOUR_COURSEWORK_ID)
    print(json.dumps(rubric, indent=4))

রুব্রিক উপস্থাপনা সম্পর্কে কিছু পয়েন্ট:

  • ক্লাসরুম UI-তে মানদণ্ড এবং স্তরের ক্রম প্রতিফলিত হয়।
  • স্কোর করা স্তরগুলি ( points সম্পত্তি সহ), অবশ্যই ক্রমবর্ধমান বা অবরোহ ক্রমে পয়েন্ট দ্বারা বাছাই করা উচিত (এগুলি এলোমেলোভাবে অর্ডার করা যাবে না)।
  • শিক্ষকরা UI-তে মানদণ্ড এবং স্কোর করা স্তরগুলি (কিন্তু অস্কোর করা স্তর নয়) পুনরায় সাজাতে সক্ষম, এবং এটি ডেটাতে তাদের ক্রম পরিবর্তন করে।

রুব্রিক কাঠামোর উপর আরো সতর্কতার জন্য সীমাবদ্ধতা দেখুন।

UI-তে ফিরে এসে, আপনাকে অ্যাসাইনমেন্টের রুব্রিক দেখতে হবে।

ক্লাসরুম UI-তে একটি রুব্রিকের দৃশ্য চিত্র 3. ক্লাসরুম অ্যাসাইনমেন্টে একটি নমুনা রুব্রিকের দৃশ্য।

একটি রুব্রিক পড়ুন

রুব্রিক্স স্ট্যান্ডার্ড List এবং Get পদ্ধতির সাথে পড়া যেতে পারে।

একটি অ্যাসাইনমেন্টে সর্বাধিক একটি রুব্রিক থাকতে পারে, তাই List স্বজ্ঞাত বলে মনে হতে পারে, তবে আপনার কাছে রুব্রিক আইডি না থাকলে এটি সহায়ক। যদি কোনো CourseWork সাথে কোনো রুব্রিক যুক্ত না থাকে, তাহলে List প্রতিক্রিয়া খালি থাকে।

main.py এ নিম্নলিখিত ফাংশন যোগ করুন:

def get_rubric(service, course_id, coursework_id):
    """
    Get the rubric on a coursework. There can only be at most one.
    Returns null if there is no rubric.
    """
    try:
        response = service.courses().courseWork().rubrics().list(
            courseId=course_id, courseWorkId=coursework_id,
            # Specify the preview version. Rubrics CRUD capabilities are
            # supported in V1_20231110_PREVIEW and later.
            previewVersion="V1_20231110_PREVIEW"
            ).execute()

        rubrics = response.get("rubrics", [])
        if not rubrics:
            print("No rubric found for this assignment.")
            return
        rubric = rubrics[0]
        return rubric

    except HttpError as error:
        print(f"An error occurred: {error}")
        return error

আপনি যে রুব্রিক যোগ করেছেন তা আনতে main.py আপডেট করুন এবং চালান:

if __name__ == '__main__':
    service = build_authenticated_service(YOUR_API_KEY)

    rubric = get_rubric(service, YOUR_COURSE_ID, YOUR_COURSEWORK_ID)
    print(json.dumps(rubric, indent=4))

    #TODO(developer): Save the printed rubric ID.

পরবর্তী পদক্ষেপের জন্য রুব্রিকের id বৈশিষ্ট্যটি নোট করুন।

আপনার রুব্রিক আইডি থাকলে ভাল কাজ Get । এর পরিবর্তে Get ইন ফাংশন ব্যবহার করা দেখতে এরকম হতে পারে:

def get_rubric(service, course_id, coursework_id, rubric_id):
    """
    Get the rubric on a coursework. There can only be at most one.
    Returns a 404 if there is no rubric.
    """
    try:
        rubric = service.courses().courseWork().rubrics().get(
            courseId=course_id,
            courseWorkId=coursework_id,
            id=rubric_id,
            # Specify the preview version. Rubrics CRUD capabilities are
            # supported in V1_20231110_PREVIEW and later.
            previewVersion="V1_20231110_PREVIEW"
        ).execute()

        return rubric

    except HttpError as error:
        print(f"An error occurred: {error}")
        return error

রুব্রিক না থাকলে এই বাস্তবায়ন একটি 404 প্রদান করে।

একটি রুব্রিক আপডেট করুন

Patch কলের মাধ্যমে রুব্রিকের আপডেট করা হয়। একটি রুব্রিকের জটিল কাঠামোর কারণে, আপডেটগুলি অবশ্যই একটি রিড-মডিফাই-রাইট প্যাটার্নের সাথে করা উচিত, যেখানে সম্পূর্ণ criteria সম্পত্তি প্রতিস্থাপন করা হয়।

আপডেট নিয়ম নিম্নরূপ:

  1. কোনো আইডি ছাড়া মানদণ্ড বা মাত্রা যোগ করা হয়েছে বলে মনে করা হয়
  2. আগে থেকে অনুপস্থিত মানদণ্ড বা স্তরগুলিকে মুছে ফেলা হিসাবে বিবেচনা করা হয়।
  3. একটি বিদ্যমান আইডি সহ মানদণ্ড বা স্তরগুলি কিন্তু পরিবর্তিত ডেটা সম্পাদনা হিসাবে বিবেচিত হয়৷ অপরিবর্তিত বৈশিষ্ট্যগুলি যেমন রয়েছে তেমনই রেখে দেওয়া হয়েছে।
  4. একটি নতুন বা অজানা আইডির সাথে সরবরাহ করা মানদণ্ড বা স্তরগুলিকে ত্রুটি হিসাবে বিবেচনা করা হয়৷
  5. নতুন মানদণ্ড এবং স্তরের ক্রমকে নতুন UI অর্ডার হিসাবে বিবেচনা করা হয় (উপরে উল্লিখিত সীমাবদ্ধতা সহ)।

একটি রুব্রিক আপডেট করার জন্য একটি ফাংশন যোগ করুন:

def update_rubric(service, course_id, coursework_id, rubric_id, body):
    """
    Updates the rubric on a coursework.
    """
    try:
        rubric = service.courses().courseWork().rubrics().patch(
            courseId=course_id,
            courseWorkId=coursework_id,
            id=rubric_id,
            body=body,
            updateMask='criteria',
            # Specify the preview version. Rubrics CRUD capabilities are
            # supported in V1_20231110_PREVIEW and later.
            previewVersion="V1_20231110_PREVIEW"
        ).execute()

        return rubric

    except HttpError as error:
        print(f"An error occurred: {error}")
        return error

এই উদাহরণে criteria ক্ষেত্রটি updateMask সাথে পরিবর্তনের জন্য নির্দিষ্ট করা হয়েছে।

তারপরে উপরে উল্লিখিত আপডেট নিয়মগুলির প্রতিটির জন্য একটি পরিবর্তন করতে main.py পরিবর্তন করুন:

if __name__ == '__main__':
    service = build_authenticated_service(YOUR_API_KEY)

    # Get the latest rubric.
    rubric = get_rubric(service, YOUR_COURSE_ID, YOUR_COURSEWORK_ID)
    criteria = rubric.get("criteria")
    """
    The "criteria" property should look like this:
    [
        {
            "id": "NkEyMdMyMzM2Nxkw",
            "title": "Argument",
            "description": "How well structured your argument is.",
            "levels": [
                {
                    "id": "NkEyMdMyMzM2Nxkx",
                    "title": "Convincing",
                    "description": "A compelling case is made.",
                    "points": 30
                },
                {
                    "id": "NkEyMdMyMzM2Nxky",
                    "title": "Passable",
                    "description": "Missing some evidence.",
                    "points": 20
                },
                {
                    "id": "NkEyMdMyMzM2Nxkz",
                    "title": "Needs Work",
                    "description": "Not enough strong evidence..",
                    "points": 0
                }
            ]
        },
        {
            "id": "NkEyMdMyMzM2Nxk0",
            "title": "Spelling",
            "description": "How well you spelled all the words.",
            "levels": [...]
        },
        {
            "id": "NkEyMdMyMzM2Nxk4",
            "title": "Grammar",
            "description": "How grammatically correct your sentences are.",
            "levels": [...]
        }
    ]
    """

    # Make edits. This example will make one of each type of change.

    # Add a new level to the first criteria. Levels must remain sorted by
    # points.
    new_level = {
        "title": "Profound",
        "description": "Truly unique insight.",
        "points": 50
    }
    criteria[0]["levels"].insert(0, new_level)

    # Remove the last criteria.
    del criteria[-1]

    # Update the criteria titles with numeric prefixes.
    for index, criterion in enumerate(criteria):
        criterion["title"] = f"{index}: {criterion['title']}"

    # Resort the levels from descending to ascending points.
    for criterion in criteria:
        criterion["levels"].sort(key=lambda level: level["points"])

    # Update the rubric with a patch call.
    new_rubric = update_rubric(
        service, YOUR_COURSE_ID, YOUR_COURSEWORK_ID, YOUR_RUBRIC_ID, rubric)

    print(json.dumps(new_rubric, indent=4))

পরিবর্তনগুলি এখন ক্লাসরুমে শিক্ষকের জন্য প্রতিফলিত হওয়া উচিত।

ক্লাসরুম UI-তে একটি আপডেট করা রুব্রিকের দৃশ্য চিত্র 4. আপডেট করা রুব্রিকের দৃশ্য।

রুব্রিক-গ্রেডেড জমাগুলি দেখুন

আপাতত, স্টুডেন্ট জমাগুলিকে API দ্বারা রুব্রিক দিয়ে গ্রেড করা যাবে না, তবে আপনি ক্লাসরুম UI-তে রুব্রিক দিয়ে গ্রেড করা জমাগুলির জন্য রুব্রিক গ্রেড পড়তে পারেন।

ক্লাসরুম UI-এর একজন ছাত্র হিসাবে, আপনার নমুনা অ্যাসাইনমেন্টটি সম্পূর্ণ করুন এবং চালু করুন । তারপর শিক্ষক হিসাবে, রুব্রিক ব্যবহার করে ম্যানুয়ালি অ্যাসাইনমেন্ট গ্রেড করুন

ক্লাসরুম UI-তে একটি রুব্রিক গ্রেডের দৃশ্য চিত্র 5. গ্রেডিংয়ের সময় রুব্রিকের শিক্ষকের দৃষ্টিভঙ্গি।

রুব্রিকের সাথে গ্রেড করা শিক্ষার্থীদের জমাগুলির দুটি নতুন বৈশিষ্ট্য রয়েছে: draftRubricGrades এবং assignedRubricGrades , ড্রাফ্ট এবং নির্ধারিত গ্রেডিং স্টেটের সময় শিক্ষক দ্বারা নির্বাচিত পয়েন্ট এবং স্তরগুলিকে প্রতিনিধিত্ব করে।

অতিরিক্তভাবে, গ্রেড করার আগেও, সংশ্লিষ্ট রুব্রিকের সাথে শিক্ষার্থীদের জমা একটি rubricId ক্ষেত্র থাকে। এটি CourseWork এর সাথে যুক্ত সর্বশেষ রুব্রিককে উপস্থাপন করে, এবং শিক্ষকরা একটি রুব্রিক মুছে ফেললে এবং পুনরায় তৈরি করলে এই মান পরিবর্তন হতে পারে।

আপনি বিদ্যমান studentSubmissions.Get এবং studentSubmissions.List পদ্ধতিগুলি গ্রেডেড জমাগুলি দেখতে ব্যবহার করতে পারেন৷

শিক্ষার্থীদের জমা তালিকাভুক্ত করতে main.py তে নিম্নলিখিত ফাংশন যোগ করুন:

def get_latest_submission(service, course_id, coursework_id):
    """Retrieves the last submission for an assignment."""
    try:
        response = service.courses().courseWork().studentSubmissions().list(
            courseId = course_id,
            courseWorkId = coursework_id,
            pageSize=1,
            # Specify the preview version. Rubrics CRUD capabilities are
            # supported in V1_20231110_PREVIEW and later.
            previewVersion="V1_20231110_PREVIEW"
        ).execute()
        submissions = response.get("studentSubmissions", [])
        if not submissions:
            print(
                """No submissions found. Did you remember to turn in and grade
                   the assignment in the UI?""")
            return
        submission = submissions[0]
        return submission

    except HttpError as error:
        print(f"An error occurred: {error}")
        return error

তারপর আপডেট করুন এবং জমা গ্রেড দেখতে main.py চালান।

if __name__ == '__main__':
    service = build_authenticated_service(YOUR_API_KEY)

    submission = get_latest_submission(
        service, YOUR_COURSE_ID, YOUR_COURSEWORK_ID)
    print(json.dumps(submission, indent=4))

draftRubricGrades এবং assignedRubricGrades রয়েছে:

  • সংশ্লিষ্ট রুব্রিকের মানদণ্ডের criterionId
  • প্রতিটি মানদণ্ডের জন্য শিক্ষক নির্ধারিত points । এটি নির্বাচিত স্তর থেকে হতে পারে, তবে শিক্ষক এটি ওভাররাইট করতে পারেন।
  • প্রতিটি মানদণ্ডের জন্য নির্বাচিত স্তরের levelId ৷ যদি শিক্ষক একটি স্তর নির্বাচন না করেন, কিন্তু তারপরও মানদণ্ডের জন্য নির্দিষ্ট পয়েন্ট, এই ক্ষেত্রটি উপস্থিত নয়৷

এই তালিকাগুলিতে শুধুমাত্র সেই মানদণ্ডের জন্য এন্ট্রি রয়েছে যেখানে একজন শিক্ষক হয় একটি স্তর নির্বাচন করেছেন বা পয়েন্ট সেট করেছেন। উদাহরণস্বরূপ, যদি একজন শিক্ষক গ্রেডিংয়ের সময় শুধুমাত্র একটি মাপদণ্ডের সাথে ইন্টারঅ্যাক্ট করতে চান, তাহলে draftRubricGrades এবং assignedRubricGrades শুধুমাত্র একটি আইটেম থাকবে, এমনকি রুব্রিকের অনেকগুলি মানদণ্ড থাকলেও।

একটি রুব্রিক মুছুন

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

def delete_rubric(service, course_id, coursework_id, rubric_id):
    """Deletes the rubric on a coursework."""
    try:
        service.courses().courseWork().rubrics().delete(
            courseId=course_id,
            courseWorkId=coursework_id,
            id=rubric_id,
            # Specify the preview version. Rubrics CRUD capabilities are
            # supported in V1_20231110_PREVIEW and later.
            previewVersion="V1_20231110_PREVIEW"
        ).execute()

    except HttpError as error:
        print(f"An error occurred: {error}")
        return error

রপ্তানি এবং আমদানি রুব্রিক

শিক্ষকদের দ্বারা পুনরায় ব্যবহারের জন্য রুব্রিকগুলি ম্যানুয়ালি Google স্প্রেডশীটে রপ্তানি করা যেতে পারে।

কোডে রুব্রিকের মানদণ্ড নির্দিষ্ট করার পাশাপাশি, criteria পরিবর্তে রুব্রিক বডিতে সোর্স sourceSpreadsheetId নির্দিষ্ট করে এই রপ্তানি করা শীটগুলি থেকে রুব্রিকগুলি তৈরি এবং আপডেট করা সম্ভব:

def create_rubric_from_sheet(service, course_id, coursework_id, sheet_id):
    """Creates an example rubric on a coursework."""
    try:
        body = {
            "sourceSpreadsheetId": sheet_id
        }

        rubric = service.courses().courseWork().rubrics().create(
            courseId=course_id, courseWorkId=coursework_id, body=body,
            # Specify the preview version. Rubrics CRUD capabilities are
            # supported in V1_20231110_PREVIEW and later.
            previewVersion="V1_20231110_PREVIEW"
            ).execute()

        print(f"Rubric created with ID {rubric.get('id')}")
        return rubric

    except HttpError as error:
        print(f"An error occurred: {error}")
        return error

প্রতিক্রিয়া

আপনি যদি কোনো সমস্যা খুঁজে পান বা ইনপুট পান, আপনার প্রতিক্রিয়া শেয়ার করুন।