Classroom API ব্যবহার করে গ্রেডিং সময়কাল পরিচালনা করুন

পাইথন

def check_grading_period_setup_eligibility(classroom, course_id):
    """Checks whether a user is able to create and modify grading periods in a course."""
    try:
        grading_period_eligibility_response = classroom.courses().checkGradingPeriodsSetupEligibility(
          courseId=course_id, previewVersion="V1_20240401_PREVIEW").execute()

        # Retrieve the isGradingPeriodsSetupEligible boolean from the response.
        # If the boolean is `True`, the user is able to modify grading period settings in the course.
        is_grading_periods_eligible = grading_period_eligibility_response.get("isGradingPeriodsSetupEligible")
        return is_grading_periods_eligible
    except HttpError as error:
        # Handle errors as appropriate for your application.
        print(f"An error occurred: {error}")
        return error

পাইথন

নিম্নলিখিত উদাহরণে, দুটি গ্রেডিং পিরিয়ড অন্তর্ভুক্ত করার জন্য gradingPeriodSettings সংস্থানটি সংশোধন করা হয়েছে। applyToExistingCoursework বুলিয়ান True এ সেট করা হয়েছে যা একটি গ্রেডিং পিরিয়ডের শুরু এবং শেষ তারিখের মধ্যে পড়ে এমন যেকোনো বিদ্যমান কোর্সওয়ার্কের gradingPeriodId পরিবর্তন করবে। নোট করুন যে updateMask উভয় ক্ষেত্র অন্তর্ভুক্ত করে। উত্তরে ফিরে আসার পরে পৃথক গ্রেডিং সময়ের জন্য আইডিগুলি সংরক্ষণ করুন। প্রয়োজনে গ্রেডিং পিরিয়ড আপডেট করতে আপনাকে এই আইডিগুলি ব্যবহার করতে হবে।

def create_grading_periods(classroom, course_id):
    """
    Create grading periods in a course and apply the grading periods
    to existing courseWork.
    """
    try:
        body = {
          "gradingPeriods": [
            {
              "title": "First Semester",
              "start_date": {
                "day": 1,
                "month": 9,
                "year": 2023
              },
              "end_date": {
                "day": 15,
                "month": 12,
                "year": 2023
              }
            },
            {
              "title": "Second Semester",
              "start_date": {
                "day": 15,
                "month": 1,
                "year": 2024
              },
              "end_date": {
                "day": 31,
                "month": 5,
                "year": 2024
              }
            }
          ],
          "applyToExistingCoursework": True
        }
        gradingPeriodSettingsResponse = classroom.courses().updateGradingPeriodSettings(
          courseId=course_id,
          updateMask='gradingPeriods,applyToExistingCoursework',
          body=body,
          previewVersion="V1_20240401_PREVIEW"
        ).execute();

        print(f"Grading period settings updated.")
        return gradingPeriodSettingsResponse

    except HttpError as error:
        # Handle errors as appropriate for your application.
        print(f"An error occurred: {error}")
        return error

পাইথন

def get_grading_period_settings(classroom, course_id):
    """Read grading periods settings in a course."""
    try:
        gradingPeriodSettings = classroom.courses().getGradingPeriodSettings(
          courseId=course_id, previewVersion="V1_20240401_PREVIEW").execute()
        return gradingPeriodSettings
    except HttpError as error:
        # Handle errors as appropriate for your application.
        print(f"An error occurred: {error}")
        return error

পাইথন

নিম্নলিখিত কোড এই গাইডের উদাহরণের উপর তৈরি করবে। "গ্রীষ্ম" শিরোনাম দিয়ে একটি নতুন গ্রেডিং পিরিয়ড তৈরি করা হয়েছে। applyToExistingCoursework বুলিয়ান অনুরোধের অংশে False এ সেট করা হয়েছে।

এটি করার জন্য, বর্তমান GradingPeriodSettings পড়া হয়, তালিকায় একটি নতুন গ্রেডিং পিরিয়ড যোগ করা হয়, এবং applyToExistingCoursework বুলিয়ান False এ সেট করা হয়। মনে রাখবেন যে যেকোন গ্রেডিং পিরিয়ড যা ইতিমধ্যে বিদ্যমান CourseWork এ প্রয়োগ করা হয়েছে তা সরানো হবে না। আগের উদাহরণে, "সেমিস্টার 1" এবং "সেমিস্টার 2" গ্রেডিং পিরিয়ড ইতিমধ্যেই বিদ্যমান কোর্সওয়ার্কে প্রয়োগ করা হয়েছে এবং পরবর্তী অনুরোধে applyToExistingCoursework যদি False এ সেট করা থাকে তাহলে CourseWork থেকে সরানো হবে না৷

def add_grading_period(classroom, course_id):
    """
    A new grading period is added to the list, but it is not applied to existing courseWork.
    """
    try:
        # Use the `GetGradingPeriodSettings` endpoint to retrieve the existing
        # grading period IDs. You will need to include these IDs in the request
        # body to make sure existing grading periods aren't deleted.
        body = {
          "gradingPeriods": [
            {
              # Specify the ID to make sure the grading period is not deleted.
              "id": "FIRST_SEMESTER_GRADING_PERIOD_ID",
              "title": "First Semester",
              "start_date": {
                "day": 1,
                "month": 9,
                "year": 2023
              },
              "end_date": {
                "day": 15,
                "month": 12,
                "year": 2023
              }
            },
            {
              # Specify the ID to make sure the grading period is not deleted.
              "id": "SECOND_SEMESTER_GRADING_PERIOD_ID",
              "title": "Second Semester",
              "start_date": {
                "day": 15,
                "month": 1,
                "year": 2024
              },
              "end_date": {
                "day": 31,
                "month": 5,
                "year": 2024
              }
            },
            {
              # Does not include an ID because this grading period is an addition.
              "title": "Summer",
              "start_date": {
                "day": 1,
                "month": 6,
                "year": 2024
              },
              "end_date": {
                "day": 31,
                "month": 8,
                "year": 2024
              }
            }
          ],
          "applyToExistingCoursework": False
        }

        gradingPeriodSettings = classroom.courses().updateGradingPeriodSettings(
          courseId=course_id, body=body, updateMask='gradingPeriods,applyToExistingCoursework',
          previewVersion="V1_20240401_PREVIEW").execute()
        return gradingPeriodSettings

    except HttpError as error:
        # Handle errors as appropriate for your application.
        print(f"An error occurred: {error}")
        return error

পাইথন

এই উদাহরণে, "সামার" গ্রেডিং পিরিয়ডের শেষ তারিখ পরিবর্তন করা হবে। applyToExistingCoursework ক্ষেত্রটি True এ সেট করা হবে। মনে রাখবেন যে এই বুলিয়ানটিকে True এ সেট করলে বিদ্যমান কোর্সওয়ার্কের সমস্ত কনফিগার করা গ্রেডিং সময়কাল প্রযোজ্য হবে। পূর্ববর্তী API অনুরোধে, বুলিয়ানকে False এ সেট করা হয়েছিল যাতে "গ্রীষ্মকালীন" গ্রেডিং সময় বিদ্যমান কোর্সওয়ার্কে প্রয়োগ করা না হয়। এখন যেহেতু এই বুলিয়ান ক্ষেত্রটি True এ সেট করা হয়েছে, "গ্রীষ্মকাল" গ্রেডিং পিরিয়ডটি মিলিত সমস্ত বিদ্যমান কোর্সওয়ার্কে প্রয়োগ করা হবে৷

def update_existing_grading_period(classroom, course_id):
    """
    An existing grading period is updated.
    """
    try:
        # Use the `GetGradingPeriodSettings` endpoint to retrieve the existing
        # grading period IDs. You will need to include these IDs in the request
        # body to make sure existing grading periods aren't deleted.
        body = {
          "gradingPeriods": [
            {
              "id": "FIRST_SEMESTER_GRADING_PERIOD_ID",
              "title": "First Semester",
              "start_date": {
                "day": 1,
                "month": 9,
                "year": 2023
              },
              "end_date": {
                "day": 15,
                "month": 12,
                "year": 2023
              }
            },
            {
              "id": "SECOND_SEMESTER_GRADING_PERIOD_ID",
              "title": "Second Semester",
              "start_date": {
                "day": 15,
                "month": 1,
                "year": 2024
              },
              "end_date": {
                "day": 31,
                "month": 5,
                "year": 2024
              }
            },
            {
              # The end date for this grading period will be modified from August 31, 2024 to September 10, 2024.
              # Include the grading period ID in the request along with the new data.
              "id": "SUMMER_GRADING_PERIOD_ID",
              "title": "Summer",
              "start_date": {
                "day": 1,
                "month": 6,
                "year": 2024
              },
              "end_date": {
                "day": 10,
                "month": 9,
                "year": 2024
              }
            }
          ],
          "applyToExistingCoursework": True
        }

        gradingPeriodSettings = classroom.courses().updateGradingPeriodSettings(
          courseId=course_id, body=body, updateMask='gradingPeriods,applyToExistingCoursework',
          previewVersion="V1_20240401_PREVIEW").execute()
        return gradingPeriodSettings

    except HttpError as error:
        # Handle errors as appropriate for your application.
        print(f"An error occurred: {error}")
        return error

পাইথন

এই নির্দেশিকায় উদাহরণটি চালিয়ে যেতে, গ্রেডিং সময়কাল বাদ দিন, "গ্রীষ্ম", এটি মুছে ফেলুন।

def delete_grading_period(classroom, course_id):
    """
    An existing grading period is deleted.
    """
    try:
        body = {
          "gradingPeriods": [
            {
              "id": "FIRST_SEMESTER_GRADING_PERIOD_ID",
              "title": "First Semester",
              "start_date": {
                "day": 1,
                "month": 9,
                "year": 2023
              },
              "end_date": {
                "day": 15,
                "month": 12,
                "year": 2023
              }
            },
            {
              "id": "SECOND_SEMESTER_GRADING_PERIOD_ID",
              "title": "Second Semester",
              "start_date": {
                "day": 15,
                "month": 1,
                "year": 2024
              },
              "end_date": {
                "day": 31,
                "month": 5,
                "year": 2024
              }
            }
          ]
        }

        gradingPeriodSettings = classroom.courses().updateGradingPeriodSettings(
          courseId=course_id, body=body, updateMask='gradingPeriods',
          previewVersion="V1_20240401_PREVIEW").execute()
        return gradingPeriodSettings

    except HttpError as error:
        # Handle errors as appropriate for your application.
        print(f"An error occurred: {error}")
        return error

পাইথন

body = {
  "dueDate": {
    "month": 6,
    "day": 10,
    "year": 2024
  },
  "dueTime": {
    "hours": 7
  },
  "gradingPeriodId": "<INSERT-GRADING-PERIOD-ID-OR-EMPTY-STRING>"
}
courseWork = classroom.courses().courseWork().patch(
  courseId=course_id, id=coursework_id, body=body,
  updateMask='dueDate,dueTime,gradingPeriodId', # include the gradingPeriodId field in the updateMask
  previewVersion="V1_20240401_PREVIEW").execute()