সংযুক্তি সঙ্গে ইন্টারঅ্যাক্ট

এই পৃষ্ঠাটি একটি সংযুক্তি তৈরি এবং ছাত্র জমা দেওয়ার সাথে কাজ করার জন্য বাস্তবায়নের বিশদ আলোচনা করে। মনে রাখবেন যে এই অনুরোধগুলি করার সময় আপনাকে সংযুক্তি-সম্পর্কিত প্যারামিটার সরবরাহ করতে হতে পারে।

একটি সংযুক্তি তৈরি করুন

উপযুক্ত কোর্সে একটি CREATE অনুরোধ জারি করে একটি সংযুক্তি তৈরি করুন courses.*.addOnAttachments.create endpoint. আপনার অনুরোধে অবশ্যই অনুরোধের অংশে AddOnAttachment এর একটি উদাহরণ অন্তর্ভুক্ত করতে হবে।

একটি সংযুক্তি তৈরি করার সময় নিম্নলিখিত ক্ষেত্রগুলি প্রয়োজন:

  • title : সংযুক্তির স্ট্রিং নাম।
  • teacherViewUri : সংযুক্তির শিক্ষক ভিউয়ের জন্য URI।
  • studentViewUri : সংযুক্তির স্টুডেন্ট ভিউয়ের জন্য URI।
  • studentWorkReviewUri : সংযুক্তিতে ছাত্রের কাজ দেখার জন্য শিক্ষকের জন্য URI। এই ক্ষেত্রটি শুধুমাত্র কার্যকলাপ-টাইপ সংযুক্তিগুলির জন্য প্রয়োজন৷

আপনি নিম্নলিখিত কিছু ঐচ্ছিক ক্ষেত্র অন্তর্ভুক্ত করতে চাইতে পারেন:

  • সংযুক্তি কখন বকেয়া হবে তা উল্লেখ করলে dueDate এবং dueTime
  • maxPoints : সংযুক্তির জন্য সর্বাধিক গ্রেড। আপনি যদি গ্রেড পাসব্যাক সমর্থন করতে চান তাহলে অবশ্যই একটি অ-শূন্য মান হতে হবে। শুধুমাত্র কার্যকলাপ-টাইপ সংযুক্তি প্রযোজ্য.

এই ক্ষেত্রগুলিতে আরও বিস্তারিত জানার জন্য AddOnAttachment রিসোর্স রেফারেন্স দেখুন।

ছাত্র জমার বিবরণ

একটি সাধারণ জমা ওয়ার্কফ্লো এই পদক্ষেপগুলি অনুসরণ করে:

  1. একজন ছাত্র একটি কার্যকলাপ সম্পূর্ণ করতে studentViewUri চালু করে।
  2. অ্যাড-অন ছাত্রদের শংসাপত্র ব্যবহার করে getAddOnContext পদ্ধতি থেকে একটি submissionId পুনরুদ্ধার করে।
  3. submissionId এবং attachmentId অ্যাড-অন ডেভেলপার দ্বারা ছাত্রের কাজের অনন্য শনাক্তকারী হিসাবে সংরক্ষণ করা হয়। কোনো শিক্ষক ক্লাসরুমে কোনো অ্যাসাইনমেন্ট কপি করলে, আপনি কপি করা অ্যাসাইনমেন্টে একটি নতুন অ্যাটাচমেন্ট প্রদর্শন করতে এই দুটি প্যারামিটারের কম্পোজিট কী ব্যবহার করতে পারেন। আরো বিস্তারিত জানার জন্য অনুলিপি করা বিষয়বস্তু আমাদের পৃষ্ঠা দেখুন.
  4. ছাত্রদের কাজের পর্যালোচনা করতে আগ্রহী একজন শিক্ষক studentWorkReviewUri চালু করেন। অনুরোধে নিম্নলিখিত ক্যোয়ারী প্যারামিটারগুলি অন্তর্ভুক্ত রয়েছে: courseId , itemId , itemType , attachmentId , এবং submissionId
  5. অ্যাড-অন ডেভেলপার ছাত্রদের কাজ পুনরুদ্ধার করতে এই চারটি আইডি ব্যবহার করে। একটি ছাত্র জমা দেওয়ার তথ্য পুনরুদ্ধার বা সংশোধন করতে courses.courseWork.addOnAttachments.studentSubmissions এন্ডপয়েন্ট ব্যবহার করুন।

জমা অবস্থা সনাক্ত করুন

একটি নির্দিষ্ট submissionId সম্পর্কে বিশদ বিবরণ পেতে courses.courseWork.addOnAttachments.studentSubmissions এন্ডপয়েন্টে একটি GET অনুরোধ ইস্যু করুন৷ আপনি একটি AddOnAttachmentStudentSubmission অবজেক্ট পাবেন, যাতে জমার গ্রেড ( pointsEarned ) এবং বর্তমান অবস্থা ( postSubmissionState ) রয়েছে। জমা দেওয়ার অবস্থা নিম্নলিখিত মানগুলির মধ্যে একটি হতে পারে:

  • NEW , যদি শিক্ষার্থী কখনোই জমাটি অ্যাক্সেস না করে থাকে।
  • CREATED , যদি শিক্ষার্থী একটি জমা তৈরি করে থাকে কিন্তু এখনও জমা না করে।
  • TURNED_IN , যদি ছাত্র শিক্ষকের কাছে তাদের কাজ জমা দিয়ে থাকে।
  • RETURNED , যদি শিক্ষক জমাটি ছাত্রকে ফেরত দেন।
  • RECLAIMED_BY_STUDENT , যদি শিক্ষার্থী তাদের কাজ "আনসাবমিট" করে থাকে।

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

  • আপনার অ্যাড-অনের মধ্যে অ্যাসাইনমেন্টের টার্ন-ইন অবস্থা প্রদর্শন করা হচ্ছে। এটি শিক্ষার্থীদের সম্ভাব্য বিভ্রান্তি এড়াতে সাহায্য করতে পারে এবং নিশ্চিত করতে পারে যে তারা ভুলবশত একটি অ্যাসাইনমেন্ট চালু করতে ব্যর্থ হয় না।
  • জমা সম্পাদনা বিশেষাধিকার সীমিত. যদি অ্যাসাইনমেন্টের স্থিতি CREATED বা RECLAIMED_BY_STUDENT থাকে, তাহলে শিক্ষার্থীকে তাদের জমা সম্পাদনা করার অনুমতি দেওয়া হতে পারে। অ্যাসাইনমেন্টের স্ট্যাটাস TURNED_IN বা RETURNED থাকলে, ছাত্রকে তাদের জমা সম্পাদনা করার অনুমতি দেওয়া নাও হতে পারে।

গ্রেড এবং একাধিক সংযুক্তি

একটি অ্যাসাইনমেন্টের জন্য গ্রেড সেট করতে শুধুমাত্র একটি অ্যাড-অন সংযুক্তি ব্যবহার করা যেতে পারে । যদি একজন শিক্ষক একাধিক অ্যাক্টিভিটি-টাইপ অ্যাটাচমেন্ট তৈরি করেন যা একটি maxPoints মান প্রদান করে, শুধুমাত্র প্রথম এই ধরনের অ্যাটাচমেন্ট অ্যাসাইনমেন্ট গ্রেড সেট করতে পারে। হয় maxPoints মান সেট না করে রেখে দিন অথবা একটি সংযুক্তির জন্য গ্রেড পাসব্যাক অক্ষম করতে শূন্যে সেট করুন।

একটি জমা এর গ্রেড সেট করুন

আপনি courses.courseWork.addOnAttachments.studentSubmissions এন্ডপয়েন্টে একটি PATCH অনুরোধ পাঠিয়ে একটি ছাত্র জমা পরিবর্তন করতে পারেন। অনুরোধের অংশে অবশ্যই সংশোধিত মানগুলির সাথে AddOnAttachmentStudentSubmission এর একটি উদাহরণ অন্তর্ভুক্ত করতে হবে। একটি জমার গ্রেড পরিবর্তন করতে pointsEarned ক্ষেত্র সেট করুন। অর্জিত pointsEarned পাস করা মানটি ক্লাসরুম UI-তে শিক্ষকের কাছে দৃশ্যমান একটি খসড়া গ্রেড হয়ে যায়। শিক্ষকরা শিক্ষার্থীদের কাছে অ্যাসাইনমেন্ট ফেরত দেওয়ার আগে খসড়া গ্রেড পরিবর্তন করতে পারেন। শিক্ষকদের কাছে কীভাবে গ্রেড উপস্থাপন করা হয় তার বিশদ বিবরণের জন্য ক্লাসরুম UI-তে গ্রেডিংয়ের ওভারভিউ দেখুন।

মনে রাখবেন যে আপনি pointsEarned সাথে গ্রেড সেট করতে পারেন শুধুমাত্র যদি নিম্নলিখিতটি সত্য হয়:

  • সংযুক্তির একটি ইতিবাচক maxPoints মান থাকতে হবে।
  • অ্যাড-অনটি অবশ্যই সংযুক্তির মূল নির্মাতা হতে হবে।

এছাড়াও নোট করুন যে আপনি addOnAttachments এন্ডপয়েন্টে একটি PATCH অনুরোধ জারি করে ইতিমধ্যেই তৈরি করা AddOnAttachment এর maxPoints মান পরিবর্তন করতে পারেন।

কখন একটি গ্রেড সেট করতে হবে

Google ক্লাসরুমে একটি গ্রেড পাস করা হলে আপনার কাছে কিছু পছন্দ আছে। গুরুত্বপূর্ণ পার্থক্য হল আপনি শিক্ষকের শংসাপত্র সংরক্ষণ করতে চান কিনা, কারণ শুধুমাত্র শিক্ষক একটি গ্রেড পরিবর্তন করতে পারেন।

দুটি অ্যাড-অন মুহূর্ত রয়েছে যেখানে আপনি Google ক্লাসরুমে একটি গ্রেড পাস করতে পারেন: যখন শিক্ষার্থী তাদের কাজ শেষ করে বা যখন শিক্ষক শিক্ষার্থীর কাজ পর্যালোচনা আইফ্রেমে শিক্ষার্থীর কাজটি খোলেন।

আপনি যদি শিক্ষার্থীর কাজ শেষ করার সময় গ্রেড সেট করতে চান, তাহলে আপনাকে অবশ্যই একজন শিক্ষকের অফলাইন শংসাপত্রগুলি সঞ্চয় করতে হবে, তারপর সেগুলি পুনরুদ্ধার করুন এবং ছাত্রটি কাজ শেষ করার সময় গ্রেড পরিবর্তন করতে ব্যবহার করুন৷ এই পদ্ধতিটি কিছু সম্ভাব্য সুবিধা প্রদান করে:

  • বিরামহীন গ্রেড আপডেট প্রদান করুন. শ্রেণীকক্ষ UI-তে গ্রেড তৈরি করতে শিক্ষকদের কোনো বিশেষ পদক্ষেপ নেওয়ার প্রয়োজন নেই।
  • একটি অ্যাসাইনমেন্টের মাধ্যমে ক্লাসের অগ্রগতির রিয়েল-টাইম অন্তর্দৃষ্টি প্রদান করুন। শিক্ষার্থীরা সম্পূর্ণ সংযুক্তি হিসাবে গ্রেড সেট করে, শিক্ষক প্রতিটি জমা না খুলেই তাদের শিক্ষার্থীদের বোঝার ধারনা পেতে পারেন।

মনে রাখবেন যে এই পদ্ধতিটি গ্রেড সিঙ্কের জন্য একটি অ্যাসিঙ্ক্রোনাস পদ্ধতির জন্যও অনুমতি দেয়। একজন শিক্ষার্থী কখন তাদের কাজ জমা দিয়েছে তা শনাক্ত করতে আপনি পর্যায়ক্রমে AddOnAttachmentStudentSubmission শেষ পয়েন্টে পোল করতে পারেন। এটি জমা দেওয়া হলে, জমা শংসাপত্রগুলি ব্যবহার করে জমা দেওয়ার গ্রেড সেট করুন।

যদি আপনি একটি ছাত্র অধিবেশন চলাকালীন শিক্ষকের শংসাপত্রগুলি লোড করতে না চান, তাহলে আপনি সক্রিয় শিক্ষকের শংসাপত্রগুলি ব্যবহার করতে পারেন যখন তারা স্টুডেন্ট ওয়ার্ক রিভিউ iframe এ ছাত্রের জমা লোড করে। যাইহোক, এটি একটি বিশেষভাবে মসৃণ ব্যবহারকারীর অভিজ্ঞতা প্রদান করতে পারে না কারণ ক্লাসরুম UI-তে গ্রেডগুলি রিয়েল টাইমে আপডেট হয় না এবং শিক্ষকদের প্রত্যেক জমার স্টুডেন্ট ওয়ার্ক রিভিউ আইফ্রেম খুলতে হবে।

অ্যাসাইনমেন্ট গ্রেডের পরিবর্তনগুলি সনাক্ত করুন

একটি অ্যাসাইনমেন্ট তৈরি হওয়ার পরে শিক্ষকদের জন্য ক্লাসরুমে গ্রেড সেটিংস সম্পাদনা করা সম্ভব। এই ধরনের সম্পাদনা অন্তর্ভুক্ত হতে পারে:

  • নির্ধারিত পয়েন্ট মান পরিবর্তন.
  • একটি অ্যাসাইনমেন্টের maxPoints মান পরিবর্তন করা।
  • অ্যাসাইনমেন্ট আদৌ গ্রেড করা উচিত কিনা তা পরিবর্তন করা।

একটি অ্যাসাইনমেন্টের বর্তমান গ্রেডিং সেটিংস দেখতে, আমরা সুপারিশ করি যে আপনি courses.courseWork এন্ডপয়েন্টে একটি GET অনুরোধ পাঠান। প্রতিক্রিয়া বর্তমান maxPoints মান অন্তর্ভুক্ত. একটি আনগ্রেডেড অ্যাসাইনমেন্টের একটি শূন্য বা শূন্য maxPoints মান থাকে।

আপনি যদি ক্লাসরুমে একটি গ্রেড পাস করে থাকেন, তাহলে একটি অ্যাড-অন সংযুক্তির জন্য গ্রেড আনতে বা পরিবর্তন করতে courses.courseWork.addOnAttachments.studentSubmissions এন্ডপয়েন্ট ব্যবহার করুন। pointsEarned ফিল্ড ব্যবহার করে গ্রেড মান সেট করা হয়। পরীক্ষা করার কথা বিবেচনা করুন এবং, যদি প্রয়োজন হয়, এই মানটি আপডেট করুন যদি আপনার পণ্যটি শিক্ষকদের একটি নির্দিষ্ট কার্যকলাপের জন্য একজন ছাত্রের স্কোর সম্পাদনা করতে দেয়।