এই পৃষ্ঠায় অ্যাটাচমেন্ট তৈরির বাস্তবায়ন সংক্রান্ত বিস্তারিত বিবরণ, ব্যবহারকারীরা অ্যাটাচমেন্ট খুললে করণীয় প্রস্তাবিত পদক্ষেপ এবং শিক্ষার্থীদের জমা দেওয়া ফাইল নিয়ে কাজ করার বিষয়ে আলোচনা করা হয়েছে। উল্লেখ্য যে, এই অনুরোধগুলো করার সময় আপনাকে অ্যাটাচমেন্ট-সম্পর্কিত প্যারামিটার সরবরাহ করতে হতে পারে।
একটি সংযুক্তি তৈরি করুন
উপযুক্ত courses.*.addOnAttachments.create এন্ডপয়েন্টে একটি CREATE রিকোয়েস্ট পাঠিয়ে একটি অ্যাটাচমেন্ট তৈরি করুন। আপনার রিকোয়েস্টের বডিতে অবশ্যই AddOnAttachment এর একটি ইনস্ট্যান্স অন্তর্ভুক্ত থাকতে হবে।
সংযুক্তি তৈরি করার সময় নিম্নলিখিত ক্ষেত্রগুলি পূরণ করা আবশ্যক:
-
title: অ্যাটাচমেন্টটির স্ট্রিং নাম। -
teacherViewUri: অ্যাটাচমেন্টটির টিচার ভিউ-এর জন্য URI। -
studentViewUri: অ্যাটাচমেন্টটির স্টুডেন্ট ভিউ-এর জন্য URI। -
studentWorkReviewUri: অ্যাটাচমেন্টে থাকা শিক্ষার্থীর কাজ দেখার জন্য শিক্ষকের URI। এই ফিল্ডটি শুধুমাত্র অ্যাক্টিভিটি-টাইপ অ্যাটাচমেন্টের জন্য আবশ্যক।
আপনি নিম্নলিখিত ঐচ্ছিক ক্ষেত্রগুলির কয়েকটি অন্তর্ভুক্ত করতে পারেন:
- অ্যাটাচমেন্টটি কখন জমা দিতে হবে তা নির্দিষ্ট করার ক্ষেত্রে
dueDateএবংdueTime। -
maxPoints: অ্যাটাচমেন্টের জন্য সর্বোচ্চ গ্রেড। গ্রেড পাসব্যাক সমর্থন করতে চাইলে এর মান অবশ্যই অশূন্য হতে হবে। শুধুমাত্র অ্যাক্টিভিটি-টাইপ অ্যাটাচমেন্টের ক্ষেত্রে প্রযোজ্য।
এই ফিল্ডগুলো সম্পর্কে আরও বিস্তারিত জানতে AddOnAttachment রিসোর্স রেফারেন্স দেখুন।
ব্যবহারকারীর পরিচয়পত্র এবং ভূমিকা যাচাই করুন
স্টুডেন্ট ভিউ আইফ্রেম , স্টুডেন্ট ওয়ার্ক রিভিউ আইফ্রেম এবং টিচার ভিউ আইফ্রেম— এই সবগুলোই ক্লাসরুম অ্যাসাইনমেন্ট পরিবর্তন করার পরিবর্তে ব্যবহারকারীর কাছে বিষয়বস্তু উপস্থাপন করার জন্য তৈরি। যখন এই ভিউগুলোর কোনো একটি খুলবে, তখন নিম্নলিখিত বিষয়গুলো করার কথা বিবেচনা করুন:
- ব্যবহারকারীর OAuth ক্রেডেনশিয়াল সংগ্রহ করুন।
- ব্যবহারকারীর ভূমিকা যাচাই করার জন্য
itemTypeউপর ভিত্তি করেcourseWork.getAddOnContext,courseWorkMaterials.getAddOnContextঅথবাannouncements.getAddOnContextঅনুরোধ পাঠান। - প্রতিক্রিয়াটি পরীক্ষা করে দেখুন
TeacherContextবাStudentContextউপস্থিত আছে কিনা। শুধুমাত্র একটিই ফেরত দেওয়া হতে পারে, যা কোর্সে ব্যবহারকারীর ভূমিকার সাথে সঙ্গতিপূর্ণ। - বর্তমান ব্যবহারকারী যদি একজন শিক্ষার্থী হন এবং
itemTypeটিcourseWorkহয়, তাহলে শিক্ষার্থীর কাজের সাথে প্রাপ্ত রেসপন্স থেকেsubmissionIdটি রেকর্ড করুন। অ্যাড-অন আইফ্রেমগুলো জুড়েsubmissionIdsএকই থাকে এবং গ্রেড ফেরত পাঠানোর জন্য ও গ্রেডিং টুলে শিক্ষকদের কাছে শিক্ষার্থীর কাজ দেখানোর জন্য এগুলো আবশ্যক। - যদি অ্যাড-অনটির কাছে
attachmentIdআগে থেকেই জানা থাকে, তাহলে উপযুক্ত অ্যাটাচমেন্ট UI দেখান। - অন্যথায়, এই সংযুক্তিটি অবশ্যই অন্য কোনো স্ট্রিম আইটেম বা কোর্স থেকে কপি করা হয়েছে। এই পরিস্থিতি সম্পর্কে সুপারিশের জন্য ‘কপি করা কন্টেন্ট পরিচালনা’ নির্দেশিকাটি দেখুন।
শিক্ষার্থীর জমা দেওয়ার বিবরণ
একটি সাধারণ জমা দেওয়ার কার্যপ্রবাহ নিম্নলিখিত ধাপগুলো অনুসরণ করে:
- একজন শিক্ষার্থী কোনো একটি কার্যকলাপ সম্পন্ন করার জন্য
studentViewUriচালু করে। - অ্যাড-অনটি শিক্ষার্থীর ক্রেডেনশিয়াল ব্যবহার করে
getAddOnContextমেথড থেকে একটিsubmissionIdসংগ্রহ করে। - অ্যাড-অন ডেভেলপার শিক্ষার্থীর কাজের অনন্য শনাক্তকারী হিসেবে
submissionIdএবংattachmentIdসংরক্ষণ করেন। কোনো শিক্ষক Classroom-এ একটি অ্যাসাইনমেন্ট কপি করলে, আপনি এই দুটি প্যারামিটারের কম্পোজিট কী ব্যবহার করে কপি করা অ্যাসাইনমেন্টে একটি নতুন অ্যাটাচমেন্ট প্রদর্শন করতে পারেন। আরও বিস্তারিত জানতে কপি করা কন্টেন্ট সম্পর্কিত আমাদের পেজটি দেখুন। - শিক্ষার্থীর কাজ পর্যালোচনা করতে আগ্রহী একজন শিক্ষক
studentWorkReviewUriচালু করেন। অনুরোধটিতে নিম্নলিখিত কোয়েরি প্যারামিটারগুলো অন্তর্ভুক্ত থাকে:courseId,itemId,itemType,attachmentId, এবংsubmissionId। - অ্যাড-অন ডেভেলপার শিক্ষার্থীর কাজ পুনরুদ্ধার করতে এই চারটি আইডি ব্যবহার করেন। শিক্ষার্থীর জমা দেওয়া কাজ সম্পর্কিত তথ্য পুনরুদ্ধার বা পরিবর্তন করতে
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 এ দেওয়া মানটি একটি ড্রাফট গ্রেড হয়ে যায়, যা শিক্ষক Classroom UI-তে দেখতে পান। শিক্ষকরা শিক্ষার্থীদের কাছে অ্যাসাইনমেন্ট ফেরত দেওয়ার আগে ড্রাফট গ্রেডটি পরিবর্তন করতে পারেন। শিক্ষকদের কাছে কীভাবে গ্রেড উপস্থাপন করা হয় সে সম্পর্কে বিস্তারিত জানতে Classroom UI-তে গ্রেডিং-এর ওভারভিউ দেখুন।
মনে রাখবেন, আপনি pointsEarned দিয়ে গ্রেড নির্ধারণ করতে পারবেন শুধুমাত্র যদি নিম্নলিখিত শর্তগুলো পূরণ হয়:
- সংযুক্তিটির
maxPointsমান অবশ্যই ধনাত্মক হতে হবে। - অ্যাড-অনটিকেই অ্যাটাচমেন্টটির মূল নির্মাতা হতে হবে।
আরও মনে রাখবেন যে, addOnAttachments এন্ডপয়েন্টে একটি PATCH অনুরোধ পাঠানোর মাধ্যমে আপনি ইতিমধ্যে তৈরি করা একটি AddOnAttachment এর maxPoints মান পরিবর্তন করতে পারেন।
কখন গ্রেড নির্ধারণ করতে হবে
কখন একটি গ্রেড গুগল ক্লাসরুমে ফেরত পাঠানো হবে, সে বিষয়ে আপনার কিছু সিদ্ধান্ত নেওয়ার সুযোগ রয়েছে। মূল পার্থক্যটি হলো আপনি শিক্ষকের পরিচয়পত্র সংরক্ষণ করবেন কি না, কারণ শুধুমাত্র শিক্ষকই একটি গ্রেড পরিবর্তন করতে পারেন।
দুটি অতিরিক্ত মুহূর্ত আছে যখন আপনি গুগল ক্লাসরুমে গ্রেড পাঠাতে পারেন: যখন শিক্ষার্থী তার কাজটি সম্পন্ন করে অথবা যখন শিক্ষক 'স্টুডেন্ট ওয়ার্ক রিভিউ' আইফ্রেমে শিক্ষার্থীর কাজটি খোলেন।
যদি আপনি শিক্ষার্থীর কাজ সম্পন্ন হওয়ার পর গ্রেড নির্ধারণ করতে চান, তবে আপনাকে অবশ্যই শিক্ষকের অফলাইন ক্রেডেনশিয়াল সংরক্ষণ করতে হবে এবং পরে শিক্ষার্থীর কাজ সম্পন্ন হলে গ্রেড পরিবর্তন করার জন্য সেগুলো পুনরুদ্ধার ও ব্যবহার করতে হবে। এই পদ্ধতির কিছু সম্ভাব্য সুবিধা রয়েছে:
- নির্বিঘ্নে গ্রেড আপডেট করুন। ক্লাসরুম UI-তে গ্রেড দেখানোর জন্য শিক্ষকদের কোনো বিশেষ পদক্ষেপ নেওয়ার প্রয়োজন নেই।
- কোনো অ্যাসাইনমেন্টের মাধ্যমে ক্লাসের অগ্রগতি সম্পর্কে রিয়েল-টাইম ধারণা দিন। শিক্ষার্থীরা অ্যাটাচমেন্ট সম্পন্ন করার সাথে সাথেই গ্রেড নির্ধারণ করার মাধ্যমে, শিক্ষকরা প্রতিটি জমা দেওয়া কাজ না খুলেই তাদের শিক্ষার্থীদের বোধগম্যতা সম্পর্কে ধারণা পেতে পারেন।
উল্লেখ্য যে, এই পদ্ধতিটি গ্রেড সিঙ্ক করার জন্য একটি অ্যাসিঙ্ক্রোনাস পদ্ধতিরও সুযোগ দেয়। কোনো শিক্ষার্থী কখন তার কাজ জমা দিয়েছে তা শনাক্ত করতে আপনি পর্যায়ক্রমে AddOnAttachmentStudentSubmission এন্ডপয়েন্টটি পোল করতে পারেন। জমা হয়ে গেলে, সংরক্ষিত ক্রেডেনশিয়াল ব্যবহার করে সাবমিশনটির গ্রেড নির্ধারণ করুন।
যদি আপনি কোনো শিক্ষার্থীর সেশন চলাকালীন শিক্ষকের ক্রেডেনশিয়াল লোড করতে না চান, তাহলে সক্রিয় শিক্ষক যখন 'Student Work Review' আইফ্রেমে শিক্ষার্থীর জমা দেওয়া কাজটি লোড করবেন, তখন আপনি তাঁর ক্রেডেনশিয়াল ব্যবহার করতে পারেন। তবে, এটি ব্যবহারকারীর জন্য খুব একটা মসৃণ অভিজ্ঞতা নাও দিতে পারে, কারণ ক্লাসরুম UI-তে গ্রেডগুলো রিয়েল টাইমে আপডেট হয় না এবং শিক্ষকদের প্রতিটি জমা দেওয়া কাজের 'Student Work Review' আইফ্রেমটি খুলতে হবে।
অ্যাসাইনমেন্টের গ্রেডে পরিবর্তন শনাক্ত করুন
অ্যাসাইনমেন্ট তৈরি করার পরেও শিক্ষকরা ক্লাসরুমে গ্রেড সেটিংস সম্পাদনা করতে পারেন। এই ধরনের সম্পাদনার মধ্যে অন্তর্ভুক্ত থাকতে পারে:
- নির্ধারিত পয়েন্টের মান পরিবর্তন করা।
- একটি অ্যাসাইনমেন্টের
maxPointsমান পরিবর্তন করা। - অ্যাসাইনমেন্টটি আদৌ মূল্যায়ন করা হবে কিনা, তা পরিবর্তন করা।
কোনো অ্যাসাইনমেন্টের বর্তমান গ্রেডিং সেটিংস দেখতে, আমরা আপনাকে courses.courseWork এন্ডপয়েন্টে একটি GET রিকোয়েস্ট পাঠানোর পরামর্শ দিই। রেসপন্সে বর্তমান maxPoints ভ্যালুটি অন্তর্ভুক্ত থাকে। গ্রেড না দেওয়া অ্যাসাইনমেন্টের maxPoints ভ্যালু null বা শূন্য হয়।
আপনি যদি Classroom-এ কোনো গ্রেড ফেরত পাঠিয়ে থাকেন, তাহলে কোনো অ্যাড-অন অ্যাটাচমেন্টের গ্রেড আনতে বা পরিবর্তন করতে courses.courseWork.addOnAttachments.studentSubmissions এন্ডপয়েন্টটি ব্যবহার করুন। pointsEarned ফিল্ড ব্যবহার করে গ্রেডের মান নির্ধারণ করা হয়। আপনার প্রোডাক্ট যদি শিক্ষকদের কোনো নির্দিষ্ট অ্যাক্টিভিটির জন্য শিক্ষার্থীর স্কোর সম্পাদনা করার সুযোগ দেয়, তাহলে এই মানটি পরীক্ষা করে দেখুন এবং প্রয়োজনে তা আপডেট করুন।