কোর্সওয়ার্ক পরিচালনা করুন

ক্লাসরুম অ্যাপটি তিন ধরনের স্ট্রিম আইটেম সমর্থন করে: CourseWork , CourseWorkMaterials , এবং Announcements । এই নির্দেশিকাটি CourseWork কীভাবে পরিচালনা করতে হয় তা বর্ণনা করে, তবে সমস্ত স্ট্রিম আইটেমের জন্য API-গুলো একই রকম। স্ট্রিম আইটেমের প্রকারভেদ এবং তাদের পার্থক্য সম্পর্কে আরও জানতে API রিসোর্স দেখুন।

CourseWork রিসোর্সটি একটি নির্দিষ্ট কোর্সের শিক্ষার্থীদের জন্য নির্ধারিত একটি কাজের আইটেমকে বোঝায়, যার মধ্যে জমা দেওয়ার শেষ তারিখ বা সর্বোচ্চ স্কোরের মতো যেকোনো অতিরিক্ত উপকরণ ও বিবরণ অন্তর্ভুক্ত থাকে। CourseWork চারটি উপপ্রকার রয়েছে: অ্যাসাইনমেন্ট , কুইজ অ্যাসাইনমেন্ট , সংক্ষিপ্ত উত্তর প্রশ্ন এবং বহুনির্বাচনী প্রশ্ন । ক্লাসরুম এপিআই এই উপপ্রকারগুলোর মধ্যে তিনটিকে সমর্থন করে: অ্যাসাইনমেন্ট, সংক্ষিপ্ত উত্তর প্রশ্ন এবং বহুনির্বাচনী প্রশ্ন। এই প্রকারগুলো CourseWork.workType ফিল্ড দ্বারা প্রকাশ করা হয়।

CourseWork রিসোর্সের পাশাপাশি, আপনি StudentSubmission রিসোর্স ব্যবহার করে সম্পন্ন করা কাজ পরিচালনা করতে পারেন।

কোর্সওয়ার্ক তৈরি করুন

CourseWork শুধুমাত্র কোর্সের শিক্ষকের পক্ষেই তৈরি করা যাবে। কোনো শিক্ষার্থী বা ডোমেইন অ্যাডমিনিস্ট্রেটরের (যিনি কোর্সের শিক্ষক নন) পক্ষে CourseWork তৈরি করার চেষ্টা করলে PERMISSION_DENIED ত্রুটি দেখা দেয়। ক্লাসরুমের বিভিন্ন ভূমিকা সম্পর্কে আরও জানতে ব্যবহারকারীর প্রকারভেদ (User types) দেখুন।

courses.courseWork.create মেথড ব্যবহার করে CourseWork তৈরি করার সময়, আপনি materials হিসেবে লিঙ্ক সংযুক্ত করতে পারেন, যেমনটি নিচের নমুনা কোডে দেখানো হয়েছে:

জাভা

classroom/snippets/src/main/java/CreateCourseWork.java
CourseWork courseWork = null;
try {
  // Create a link to add as a material on course work.
  Link articleLink =
      new Link()
          .setTitle("SR-71 Blackbird")
          .setUrl("https://www.lockheedmartin.com/en-us/news/features/history/blackbird.html");

  // Create a list of Materials to add to course work.
  List<Material> materials = Arrays.asList(new Material().setLink(articleLink));

  /* Create new CourseWork object with the material attached.
  Set workType to `ASSIGNMENT`. Possible values of workType can be found here:
  https://developers.google.com/classroom/reference/rest/v1/CourseWorkType
  Set state to `PUBLISHED`. Possible values of state can be found here:
  https://developers.google.com/classroom/reference/rest/v1/courses.courseWork#courseworkstate */
  CourseWork content =
      new CourseWork()
          .setTitle("Supersonic aviation")
          .setDescription(
              "Read about how the SR-71 Blackbird, the world’s fastest and "
                  + "highest-flying manned aircraft, was built.")
          .setMaterials(materials)
          .setWorkType("ASSIGNMENT")
          .setState("PUBLISHED");

  courseWork = service.courses().courseWork().create(courseId, content).execute();

  /* Prints the created courseWork. */
  System.out.printf("CourseWork created: %s\n", courseWork.getTitle());
} catch (GoogleJsonResponseException e) {
  // TODO (developer) - handle error appropriately
  GoogleJsonError error = e.getDetails();
  if (error.getCode() == 404) {
    System.out.printf("The courseId does not exist: %s.\n", courseId);
  } else {
    throw e;
  }
  throw e;
} catch (Exception e) {
  throw e;
}
return courseWork;

পাইথন

classroom/snippets/classroom_create_coursework.py
import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError


def classroom_create_coursework(course_id):
  """
  Creates the coursework the user has access to.
  Load pre-authorized user credentials from the environment.
  TODO(developer) - See https://developers.google.com/identity
  for guides on implementing OAuth2 for the application.
  """

  creds, _ = google.auth.default()
  # pylint: disable=maybe-no-member

  try:
    service = build("classroom", "v1", credentials=creds)
    coursework = {
        "title": "Ant colonies",
        "description": """Read the article about ant colonies
                              and complete the quiz.""",
        "materials": [
            {"link": {"url": "http://example.com/ant-colonies"}},
            {"link": {"url": "http://example.com/ant-quiz"}},
        ],
        "workType": "ASSIGNMENT",
        "state": "PUBLISHED",
    }
    coursework = (
        service.courses()
        .courseWork()
        .create(courseId=course_id, body=coursework)
        .execute()
    )
    print(f"Assignment created with ID {coursework.get('id')}")
    return coursework

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


if __name__ == "__main__":
  # Put the course_id of course whose coursework needs to be created,
  # the user has access to.
  classroom_create_coursework(453686957652)

title এবং workType ক্ষেত্র দুটি আবশ্যক। অন্য সব ক্ষেত্র ঐচ্ছিক। state নির্দিষ্ট না করা থাকলে, CourseWork খসড়া অবস্থায় তৈরি হয়।

CourseWork লিঙ্ক করা উপকরণ অন্তর্ভুক্ত করতে একটি নির্দিষ্ট টার্গেট url সহ একটি লিঙ্ক রিসোর্স ব্যবহার করুন। ক্লাসরুম স্বয়ংক্রিয়ভাবে title এবং থাম্বনেইল ছবির ইউআরএল ( thumbnailUrl ) সংগ্রহ করে। ক্লাসরুম এপিআই গুগল ড্রাইভ এবং ইউটিউবের উপকরণগুলোকেও স্বাভাবিকভাবে সমর্থন করে, যেগুলো একইভাবে একটি DriveFile রিসোর্স বা YouTubeVideo রিসোর্সের মাধ্যমে অন্তর্ভুক্ত করা যেতে পারে।

একটি নির্ধারিত তারিখ নির্দিষ্ট করতে, dueDate এবং dueTime ফিল্ড দুটিকে সংশ্লিষ্ট UTC সময়ে সেট করুন। নির্ধারিত তারিখটি অবশ্যই ভবিষ্যতের হতে হবে।

CourseWork রেসপন্সে একটি সার্ভার-নির্ধারিত আইডেন্টিফায়ার অন্তর্ভুক্ত থাকে, যা অন্যান্য API রিকোয়েস্টে অ্যাসাইনমেন্টটিকে রেফারেন্স করার জন্য ব্যবহার করা যেতে পারে।

কোর্সওয়ার্ক পুনরুদ্ধার করুন

আপনি সংশ্লিষ্ট কোর্সের শিক্ষার্থী এবং শিক্ষকদের পক্ষ থেকে CourseWork পুনরুদ্ধার করতে পারেন। আপনি ডোমেইন অ্যাডমিনিস্ট্রেটরদের পক্ষ থেকেও CourseWork পুনরুদ্ধার করতে পারেন, এমনকি যদি তারা সেই কোর্সের শিক্ষক নাও হন। একটি নির্দিষ্ট CourseWork পুনরুদ্ধার করতে, courses.courseWork.get ব্যবহার করুন। সমস্ত CourseWork (ঐচ্ছিকভাবে কিছু শর্ত পূরণ সাপেক্ষে) পুনরুদ্ধার করতে, courses.courseWork.list ব্যবহার করুন।

প্রয়োজনীয় স্কোপটি কোর্সে অনুরোধকারী ব্যবহারকারীর ভূমিকার উপর নির্ভর করে। ব্যবহারকারী যদি একজন শিক্ষার্থী হন, তাহলে নিম্নলিখিত স্কোপগুলোর মধ্যে একটি ব্যবহার করুন:

  • https://www.googleapis.com/auth/classroom.coursework.me.readonly
  • https://www.googleapis.com/auth/classroom.coursework.me

ব্যবহারকারী যদি একজন শিক্ষক বা ডোমেইন প্রশাসক হন, তাহলে নিম্নলিখিত স্কোপগুলির মধ্যে একটি ব্যবহার করুন:

  • https://www.googleapis.com/auth/classroom.coursework.students.readonly
  • https://www.googleapis.com/auth/classroom.coursework.students

CourseWork পুনরুদ্ধার করার অনুমতি থাকলেই যে উপকরণ বা উপকরণের মেটাডেটা অ্যাক্সেস করার অনুমতি পাওয়া যাবে, তা নয়। বাস্তবে, এর অর্থ হলো, কোনো প্রশাসক যদি কোর্সের সদস্য না হন, তাহলে তিনি সংযুক্ত ড্রাইভ ফাইলের শিরোনাম দেখতে নাও পারেন।

শিক্ষার্থীদের প্রতিক্রিয়া পরিচালনা করুন

একটি StudentSubmission রিসোর্স কোনো CourseWork জন্য একজন শিক্ষার্থীর করা কাজকে উপস্থাপন করে। এই রিসোর্সে কাজটি সম্পর্কিত মেটাডেটা অন্তর্ভুক্ত থাকে, যেমন কাজের অবস্থা এবং গ্রেড। যখন একটি নতুন CourseWork তৈরি করা হয়, তখন প্রতিটি শিক্ষার্থীর জন্য স্বয়ংক্রিয়ভাবে একটি StudentSubmission তৈরি হয়ে যায়।

নিম্নলিখিত বিভাগগুলিতে শিক্ষার্থীদের প্রতিক্রিয়া ব্যবস্থাপনার জন্য প্রচলিত পদক্ষেপগুলি ব্যাখ্যা করা হয়েছে।

শিক্ষার্থীদের প্রতিক্রিয়া সংগ্রহ করুন

শিক্ষার্থীরা তাদের নিজেদের সাবমিশন পুনরুদ্ধার করতে পারে, শিক্ষকরা তাদের কোর্সের সকল শিক্ষার্থীর সাবমিশন পুনরুদ্ধার করতে পারেন এবং ডোমেইন অ্যাডমিনিস্ট্রেটররা তাদের ডোমেইনের সকল শিক্ষার্থীর সমস্ত সাবমিশন পুনরুদ্ধার করতে পারেন। প্রতিটি StudentSubmission একটি আইডেন্টিফায়ার দেওয়া হয়। যদি আপনি আইডেন্টিফায়ারটি জানেন, তবে সাবমিশনটি পুনরুদ্ধার করতে courses.courseWork.studentSubmissions.get ব্যবহার করুন।

নিম্নলিখিত নমুনায় দেখানো অনুযায়ী, নির্দিষ্ট শর্ত পূরণ করে এমন সমস্ত StudentSubmission রিসোর্স পেতে courses.courseWork.studentSubmissions.list মেথডটি ব্যবহার করুন:

জাভা

classroom/snippets/src/main/java/ListSubmissions.java
List<StudentSubmission> studentSubmissions = new ArrayList<>();
String pageToken = null;

try {
  do {
    ListStudentSubmissionsResponse response =
        service
            .courses()
            .courseWork()
            .studentSubmissions()
            .list(courseId, courseWorkId)
            .setPageToken(pageToken)
            .execute();

    /* Ensure that the response is not null before retrieving data from it to avoid errors. */
    if (response.getStudentSubmissions() != null) {
      studentSubmissions.addAll(response.getStudentSubmissions());
      pageToken = response.getNextPageToken();
    }
  } while (pageToken != null);

  if (studentSubmissions.isEmpty()) {
    System.out.println("No student submission found.");
  } else {
    for (StudentSubmission submission : studentSubmissions) {
      System.out.printf(
          "Student id (%s), student submission id (%s)\n",
          submission.getUserId(), submission.getId());
    }
  }
} catch (GoogleJsonResponseException e) {
  // TODO (developer) - handle error appropriately
  GoogleJsonError error = e.getDetails();
  if (error.getCode() == 404) {
    System.out.printf(
        "The courseId (%s) or courseWorkId (%s) does not exist.\n", courseId, courseWorkId);
  } else {
    throw e;
  }
} catch (Exception e) {
  throw e;
}
return studentSubmissions;

পাইথন

classroom/snippets/classroom_list_submissions.py
import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError


def classroom_list_submissions(course_id, coursework_id):
  """
  Creates the courses the user has access to.
  Load pre-authorized user credentials from the environment.
  TODO(developer) - See https://developers.google.com/identity
  for guides on implementing OAuth2 for the application.
  """

  creds, _ = google.auth.default()
  # pylint: disable=maybe-no-member
  submissions = []
  page_token = None

  try:
    service = build("classroom", "v1", credentials=creds)
    while True:
      coursework = service.courses().courseWork()
      response = (
          coursework.studentSubmissions()
          .list(
              pageToken=page_token,
              courseId=course_id,
              courseWorkId=coursework_id,
              pageSize=10,
          )
          .execute()
      )
      submissions.extend(response.get("studentSubmissions", []))
      page_token = response.get("nextPageToken", None)
      if not page_token:
        break

    if not submissions:
      print("No student submissions found.")

    print("Student Submissions:")
    for submission in submissions:
      print(
          "Submitted at:"
          f"{(submission.get('id'), submission.get('creationTime'))}"
      )

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


if __name__ == "__main__":
  # Put the course_id and coursework_id of course whose list needs to be
  # submitted.
  classroom_list_submissions(453686957652, 466086979658)

নিম্নলিখিত নমুনায় দেখানো অনুযায়ী, userId প্যারামিটারটি উল্লেখ করে কোনো নির্দিষ্ট শিক্ষার্থীর StudentSubmission রিসোর্সসমূহ পুনরুদ্ধার করুন:

জাভা

classroom/snippets/src/main/java/ListStudentSubmissions.java
List<StudentSubmission> studentSubmissions = new ArrayList<>();
String pageToken = null;

try {
  do {
    // Set the userId as a query parameter on the request.
    ListStudentSubmissionsResponse response =
        service
            .courses()
            .courseWork()
            .studentSubmissions()
            .list(courseId, courseWorkId)
            .setPageToken(pageToken)
            .set("userId", userId)
            .execute();

    /* Ensure that the response is not null before retrieving data from it to avoid errors. */
    if (response.getStudentSubmissions() != null) {
      studentSubmissions.addAll(response.getStudentSubmissions());
      pageToken = response.getNextPageToken();
    }
  } while (pageToken != null);

  if (studentSubmissions.isEmpty()) {
    System.out.println("No student submission found.");
  } else {
    for (StudentSubmission submission : studentSubmissions) {
      System.out.printf("Student submission: %s.\n", submission.getId());
    }
  }

পাইথন

classroom/snippets/classroom_list_student_submissions.py
import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError


def classroom_list_student_submissions(course_id, coursework_id, user_id):
  """
  Creates the courses the user has access to.
  Load pre-authorized user credentials from the environment.
  TODO(developer) - See https://developers.google.com/identity
  for guides on implementing OAuth2 for the application.
  """

  creds, _ = google.auth.default()
  # pylint: disable=maybe-no-member
  submissions = []
  page_token = None

  try:
    service = build("classroom", "v1", credentials=creds)
    while True:
      coursework = service.courses().courseWork()
      response = (
          coursework.studentSubmissions()
          .list(
              pageToken=page_token,
              courseId=course_id,
              courseWorkId=coursework_id,
              userId=user_id,
          )
          .execute()
      )
      submissions.extend(response.get("studentSubmissions", []))
      page_token = response.get("nextPageToken", None)
      if not page_token:
        break

    if not submissions:
      print("No student submissions found.")

    print("Student Submissions:")
    for submission in submissions:
      print(
          "Submitted at:"
          f"{(submission.get('id'), submission.get('creationTime'))}"
      )

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


if __name__ == "__main__":
  # Put the course_id, coursework_id and user_id of course whose list needs
  # to be submitted.
  classroom_list_student_submissions(453686957652, 466086979658, "me")

Student রিসোর্সে প্রদর্শিত অনন্য আইডি বা ইমেল ঠিকানার মাধ্যমে শিক্ষার্থীদের শনাক্ত করা হয়। বর্তমান ব্যবহারকারী "me" সংক্ষিপ্ত রূপটি ব্যবহার করে নিজের আইডি উল্লেখ করতে পারেন।

একটি কোর্সের অন্তর্গত সমস্ত অ্যাসাইনমেন্টের জন্য শিক্ষার্থীদের জমা দেওয়া কাজও পুনরুদ্ধার করা সম্ভব। তা করার জন্য, নিম্নলিখিত নমুনায় দেখানো অনুযায়ী courseWorkId হিসেবে আক্ষরিক "-" ব্যবহার করুন:

জাভা 

service.courses().courseWork().studentSubmissions()
    .list(courseId, "-")
    .set("userId", userId)
    .execute();

পাইথন 

service.courses().courseWork().studentSubmissions().list(
    courseId=<course ID or alias>,
    courseWorkId='-',
    userId=<user ID>).execute()

প্রয়োজনীয় স্কোপ নির্ভর করে কোর্সে অনুরোধকারী ব্যবহারকারীর ভূমিকার উপর। যদি ব্যবহারকারী একজন শিক্ষক বা ডোমেইন অ্যাডমিনিস্ট্রেটর হন, তাহলে নিম্নলিখিত স্কোপটি ব্যবহার করুন:

  • https://www.googleapis.com/auth/classroom.coursework.students.readonly
  • https://www.googleapis.com/auth/classroom.coursework.students

ব্যবহারকারী যদি শিক্ষার্থী হন, তাহলে নিম্নলিখিত স্কোপটি ব্যবহার করুন:

  • https://www.googleapis.com/auth/classroom.coursework.me.readonly
  • https://www.googleapis.com/auth/classroom.coursework.me

কোনো StudentSubmission পুনরুদ্ধার করার অনুমতি থাকলেই যে তার সাথে থাকা অ্যাটাচমেন্ট বা মেটাডেটা দেখার অনুমতি পাওয়া যাবে, তা নয়। বাস্তবে, এর অর্থ হলো, কোনো প্রশাসক যদি কোর্সটির সদস্য না হন, তবে তিনি সংযুক্ত ড্রাইভ ফাইলের শিরোনাম দেখতে নাও পারেন।

শিক্ষার্থীর উত্তরে সংযুক্তি যোগ করুন

আপনি একটি Link , DriveFile , বা YouTubeVideo রিসোর্স সংযুক্ত করে শিক্ষার্থীর জমা দেওয়া কাজের সাথে লিঙ্ক যুক্ত করতে পারেন। এটি courses.courseWork.studentSubmissions.modifyAttachments ব্যবহার করে করা হয়, যেমনটি নিম্নলিখিত নমুনায় দেখানো হয়েছে:

জাভা

classroom/snippets/src/main/java/ModifyAttachmentsStudentSubmission.java
StudentSubmission studentSubmission = null;
try {
  // Create ModifyAttachmentRequest object that includes a new attachment with a link.
  Link link = new Link().setUrl("https://en.wikipedia.org/wiki/Irrational_number");
  Attachment attachment = new Attachment().setLink(link);
  ModifyAttachmentsRequest modifyAttachmentsRequest =
      new ModifyAttachmentsRequest().setAddAttachments(Arrays.asList(attachment));

  // The modified studentSubmission object is returned with the new attachment added to it.
  studentSubmission =
      service
          .courses()
          .courseWork()
          .studentSubmissions()
          .modifyAttachments(courseId, courseWorkId, id, modifyAttachmentsRequest)
          .execute();

  /* Prints the modified student submission. */
  System.out.printf(
      "Modified student submission attachments: '%s'.\n",
      studentSubmission.getAssignmentSubmission().getAttachments());
} catch (GoogleJsonResponseException e) {
  // TODO (developer) - handle error appropriately
  GoogleJsonError error = e.getDetails();
  if (error.getCode() == 404) {
    System.out.printf(
        "The courseId (%s), courseWorkId (%s), or studentSubmissionId (%s) does "
            + "not exist.\n",
        courseId, courseWorkId, id);
  } else {
    throw e;
  }
} catch (Exception e) {
  throw e;
}
return studentSubmission;

পাইথন

classroom/snippets/classroom_add_attachment.py
def classroom_add_attachment(course_id, coursework_id, submission_id):
  """
  Adds attachment to existing course with specific course_id.
  Load pre-authorized user credentials from the environment.
  TODO(developer) - See https://developers.google.com/identity
  for guides on implementing OAuth2 for the application.
  """
  creds, _ = google.auth.default()
  # pylint: disable=maybe-no-member
  request = {
      "addAttachments": [
          {"link": {"url": "http://example.com/quiz-results"}},
          {"link": {"url": "http://example.com/quiz-reading"}},
      ]
  }

  try:
    service = build("classroom", "v1", credentials=creds)
    while True:
      coursework = service.courses().courseWork()
      coursework.studentSubmissions().modifyAttachments(
          courseId=course_id,
          courseWorkId=coursework_id,
          id=submission_id,
          body=request,
      ).execute()

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


if __name__ == "__main__":
  # Put the course_id, coursework_id and submission_id of course in which
  # attachment needs to be added.
  classroom_add_attachment("course_id", "coursework_id", "me")

একটি Link অ্যাটাচমেন্ট তার টার্গেট url দ্বারা সংজ্ঞায়িত হয়; ক্লাসরুম স্বয়ংক্রিয়ভাবে title এবং থাম্বনেইল ইমেজ ( thumbnailUrl ) নিয়ে আসে। StudentSubmissions সাথে কোন কোন উপকরণ সংযুক্ত করা যেতে পারে, সে সম্পর্কে জানতে ' Material দেখুন।

StudentSubmission শুধুমাত্র কোর্স শিক্ষক অথবা এর স্বত্বাধিকারী শিক্ষার্থীই পরিবর্তন করতে পারবেন। আপনি কেবল তখনই Materials সংযুক্ত করতে পারবেন, যদি StudentSubmission CourseWorkType ‘ ASSIGNMENT ) হয়।

প্রয়োজনীয় পরিধি নির্ভর করে কোর্সে অনুরোধকারী ব্যবহারকারীর ভূমিকার উপর। যদি ব্যবহারকারী একজন শিক্ষক হন, তাহলে নিম্নলিখিত পরিধি ব্যবহার করুন:

  • https://www.googleapis.com/auth/classroom.coursework.students

ব্যবহারকারী যদি শিক্ষার্থী হন, তাহলে নিম্নলিখিত স্কোপটি ব্যবহার করুন:

  • https://www.googleapis.com/auth/classroom.coursework.me
পরবর্তী
বিষয়গুলি তৈরি করুন এবং পরিচালনা করুন৷