এই পৃষ্ঠায় সংযুক্তি তৈরির বাস্তবায়নের বিশদ, ব্যবহারকারীরা সংযুক্তি খোলার সময় প্রস্তাবিত পদক্ষেপ এবং শিক্ষার্থীদের জমা দেওয়ার সাথে কাজ করার বিষয়ে আলোচনা করা হয়েছে। মনে রাখবেন যে এই অনুরোধগুলি করার সময় আপনাকে সংযুক্তি-সম্পর্কিত পরামিতি সরবরাহ করতে হতে পারে।
একটি সংযুক্তি তৈরি করুন
উপযুক্ত কোর্সগুলিতে একটি CREATE অনুরোধ জারি করে একটি সংযুক্তি তৈরি করুন courses.*.addOnAttachments.create endpoint। আপনার অনুরোধে অনুরোধের মূল অংশে 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অ্যাড-অন ডেভেলপার দ্বারা শিক্ষার্থীর কাজের অনন্য শনাক্তকারী হিসেবে সংরক্ষণ করা হয়। যদি কোনও শিক্ষক ক্লাসরুমে কোনও অ্যাসাইনমেন্ট কপি করেন, তাহলে আপনি কপি করা অ্যাসাইনমেন্টে একটি নতুন অ্যাটাচমেন্ট প্রদর্শন করতে এই দুটি প্যারামিটারের কম্পোজিট কী ব্যবহার করতে পারেন। আরও বিস্তারিত জানার জন্য কপি করা কন্টেন্ট সম্পর্কে আমাদের পৃষ্ঠাটি দেখুন। - একজন শিক্ষক যিনি ছাত্রদের কাজ পর্যালোচনা করতে আগ্রহী তিনি
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 এ পাস করা মানটি ক্লাসরুম UI-তে শিক্ষকের কাছে দৃশ্যমান একটি ড্রাফ্ট গ্রেডে পরিণত হয়। শিক্ষার্থীদের অ্যাসাইনমেন্ট ফেরত দেওয়ার আগে শিক্ষকরা ড্রাফ্ট গ্রেড পরিবর্তন করতে পারেন। শিক্ষকদের কাছে গ্রেড কীভাবে উপস্থাপন করা হয় সে সম্পর্কে বিস্তারিত জানতে ক্লাসরুম UI-তে গ্রেডিংয়ের ওভারভিউ দেখুন।
মনে রাখবেন যে আপনি pointsEarned দিয়ে গ্রেড সেট করতে পারবেন শুধুমাত্র যদি নিম্নলিখিতগুলি সত্য হয়:
- সংযুক্তিটির একটি ধনাত্মক
maxPointsমান থাকতে হবে। - অ্যাড-অনটি অবশ্যই সংযুক্তির মূল নির্মাতা হতে হবে।
মনে রাখবেন যে আপনি addOnAttachments এন্ডপয়েন্টে একটি PATCH অনুরোধ জারি করে ইতিমধ্যে তৈরি AddOnAttachment এর maxPoints মান পরিবর্তন করতে পারেন।
কখন গ্রেড নির্ধারণ করতে হবে
গুগল ক্লাসরুমে গ্রেড ফেরত পাঠানোর ক্ষেত্রে আপনার কিছু বিকল্প আছে। গুরুত্বপূর্ণ পার্থক্য হল আপনি শিক্ষকের শংসাপত্র সংরক্ষণ করবেন কিনা, কারণ শুধুমাত্র শিক্ষকই গ্রেড পরিবর্তন করতে পারেন।
দুটি অ্যাড-অন মুহূর্ত আছে যেখানে আপনি গুগল ক্লাসরুমে গ্রেড পাস করতে পারেন: যখন শিক্ষার্থী তার কাজ সম্পন্ন করে অথবা যখন শিক্ষক স্টুডেন্ট ওয়ার্ক রিভিউ আইফ্রেমে শিক্ষার্থীর কাজটি খোলেন।
যদি আপনি শিক্ষার্থীর কাজ শেষ করার পর গ্রেড নির্ধারণ করতে চান, তাহলে আপনাকে শিক্ষকের অফলাইন শংসাপত্র সংরক্ষণ করতে হবে, তারপর শিক্ষার্থীর কাজ শেষ করার পর গ্রেড পরিবর্তন করার জন্য সেগুলি পুনরুদ্ধার করতে হবে এবং ব্যবহার করতে হবে। এই পদ্ধতিটি কিছু সম্ভাব্য সুবিধা প্রদান করে:
- নির্বিঘ্নে গ্রেড আপডেট প্রদান করুন। ক্লাসরুমের UI-তে গ্রেড পূরণ করার জন্য শিক্ষকদের কোনও বিশেষ পদক্ষেপ নেওয়ার প্রয়োজন নেই।
- একটি অ্যাসাইনমেন্টের মাধ্যমে ক্লাসের অগ্রগতি সম্পর্কে রিয়েল-টাইম অন্তর্দৃষ্টি প্রদান করুন। শিক্ষার্থীরা অ্যাটাচমেন্ট সম্পূর্ণ করার সাথে সাথে গ্রেড সেট করে, শিক্ষকরা প্রতিটি জমা না খুলেই তাদের শিক্ষার্থীদের বোধগম্যতা সম্পর্কে ধারণা পেতে পারেন।
মনে রাখবেন যে এই পদ্ধতিটি গ্রেড সিঙ্কের জন্য একটি অ্যাসিঙ্ক্রোনাস পদ্ধতিরও অনুমতি দেয়। আপনি পর্যায়ক্রমে AddOnAttachmentStudentSubmission এন্ডপয়েন্টটি পোল করতে পারেন যাতে কোনও শিক্ষার্থী কখন তাদের কাজ জমা দিয়েছে তা সনাক্ত করা যায়। জমা দেওয়া হয়ে গেলে, সঞ্চিত শংসাপত্র ব্যবহার করে জমা দেওয়ার গ্রেড সেট করুন।
যদি আপনি ছাত্র সেশনের সময় শিক্ষকের শংসাপত্র লোড করতে না চান, তাহলে আপনি সক্রিয় শিক্ষকের শংসাপত্র ব্যবহার করতে পারেন যখন তারা ছাত্রের জমাটি স্টুডেন্ট ওয়ার্ক রিভিউ আইফ্রেমে লোড করে। তবে, এটি একটি বিশেষভাবে মসৃণ ব্যবহারকারীর অভিজ্ঞতা প্রদান নাও করতে পারে কারণ ক্লাসরুম UI-তে গ্রেডগুলি রিয়েল টাইমে আপডেট হয় না এবং শিক্ষকদের প্রতিটি জমা দেওয়ার স্টুডেন্ট ওয়ার্ক রিভিউ আইফ্রেম খুলতে হবে।
অ্যাসাইনমেন্ট গ্রেডের পরিবর্তনগুলি সনাক্ত করুন
অ্যাসাইনমেন্ট তৈরি হওয়ার পর শিক্ষকরা ক্লাসরুমে গ্রেড সেটিংস সম্পাদনা করতে পারেন। এই ধরনের সম্পাদনাগুলির মধ্যে অন্তর্ভুক্ত থাকতে পারে:
- নির্ধারিত পয়েন্টের মান পরিবর্তন করা হচ্ছে।
- একটি অ্যাসাইনমেন্টের
maxPointsমান পরিবর্তন করা হচ্ছে। - অ্যাসাইনমেন্টটি আদৌ গ্রেড করা উচিত কিনা তা পরিবর্তন করা।
কোনও অ্যাসাইনমেন্টের বর্তমান গ্রেডিং সেটিংস দেখতে, আমরা আপনাকে courses.courseWork এন্ডপয়েন্টে একটি GET অনুরোধ পাঠানোর পরামর্শ দিচ্ছি। প্রতিক্রিয়াটিতে বর্তমান maxPoints মান অন্তর্ভুক্ত থাকে। একটি অ-গ্রেডেড অ্যাসাইনমেন্টের একটি নাল বা শূন্য maxPoints মান থাকে।
যদি আপনি ক্লাসরুমে ফিরে কোনও গ্রেড পাস করে থাকেন, তাহলে courses.courseWork.addOnAttachments.studentSubmissions এন্ডপয়েন্ট ব্যবহার করে অ্যাড-অন সংযুক্তির জন্য গ্রেড আনুন বা পরিবর্তন করুন। গ্রেড মান pointsEarned ক্ষেত্র ব্যবহার করে সেট করা হয়। আপনার পণ্য শিক্ষকদের একটি নির্দিষ্ট কার্যকলাপের জন্য একজন শিক্ষার্থীর স্কোর সম্পাদনা করার অনুমতি দেয় কিনা তা পরীক্ষা করে দেখুন এবং প্রয়োজনে এই মানটি আপডেট করুন।