অ্যাড-অন প্রয়োজনীয়তা

সংস্করণ ১.১, ৫ ডিসেম্বর, ২০২৪।

এই পৃষ্ঠার মানদণ্ডগুলি সমস্ত Classroom অ্যাড-অনের ক্ষেত্রে প্রযোজ্য। Google Workspace Marketplace-এ তালিকাভুক্তির জন্য অনুমোদিত হওয়ার জন্য আপনার অ্যাড-অনটিকে সমস্ত প্রযোজ্য প্রয়োজনীয় আইটেম পূরণ করতে হবে এবং একটি অ্যাড-অন যা "Classroom-এর সাথে কাজ করে"।

এই নথিতে "অবশ্যই", "অবশ্যই নয়", "প্রয়োজনীয়", "হবে", "হবে না", "হবে না", "হবে না", "প্রস্তাবিত", "হবে", এবং "ঐচ্ছিক" এই মূল শব্দগুলি RFC 2119- এ বর্ণিত পদ্ধতিতে ব্যাখ্যা করতে হবে।

আবশ্যকতা

আইডি আদর্শ
১.০ শেষ ব্যবহারকারী লাইসেন্স (যদি প্রযোজ্য হয়)
১.১ ব্যবহারকারীর লাইসেন্স না থাকলে ব্যবহারকারীকে একটি ব্যবহারকারী-বান্ধব বার্তা দেখানো উচিত। বার্তাটিতে স্পষ্টভাবে উল্লেখ করা উচিত যে কেন অ্যাড-অনটি ব্যবহার করা যাবে না এবং পরিস্থিতির প্রতিকারের জন্য ব্যবহারকারীর জন্য পদক্ষেপ নেওয়ার পরামর্শ দেওয়া উচিত। প্রস্তাবিত
১.৩ অ্যাড-অনের জন্য Google Workspace Marketplace তালিকায় অ্যাড-অন ব্যবহারের জন্য প্রয়োজনীয় লাইসেন্স এবং সাবস্ক্রিপশনের প্রয়োজনীয়তা সম্পর্কে বিস্তারিত উল্লেখ করা উচিত। যদি অ্যাড-অনের একটি পেইড টিয়ার থাকে, তাহলে মার্কেটপ্লেস তালিকায় এমন একটি ওয়েব পৃষ্ঠার লিঙ্ক দেওয়া উচিত যা মূল্য নির্ধারণ বা বিক্রয়কর্মীর সাথে কীভাবে যোগাযোগ করবেন সে সম্পর্কে আরও তথ্য প্রদান করে। প্রস্তাবিত
২.০ শেষ ব্যবহারকারীর সাইন-ইন
২.১ শিক্ষক ব্যবহারকারীদের Google SSO ব্যবহার করে অ্যাড-অনে সাইন ইন করতে হবে।
যদি শিক্ষার্থী ব্যবহারকারীদের অ্যাড-অনে সাইন-ইন করতে বলা হয়, তাহলে তাদের অবশ্যই Google SSO ব্যবহার করে সাইন ইন করতে হবে।
প্রয়োজনীয়
২.২ পরবর্তী ভিজিটে লগইন প্রম্পট না দেখিয়েই ব্যবহারকারীকে স্বয়ংক্রিয়ভাবে সাইন ইন করতে অ্যাড-অনটিকে অবশ্যই Google SSO ব্যবহার করতে হবে।
যখন লগইন ইঙ্গিতটি বর্তমানে সাইন-ইন করা ব্যবহারকারীর সাথে মিল খুঁজে না পায়, তখন অ্যাড-অনটি অবশ্যই একটি সাইন-ইন বোতাম ব্যবহার করে ব্যবহারকারীকে অনুরোধ করবে এবং অবৈধ অ্যাকাউন্টগুলি ফিল্টার করার জন্য auth লাইব্রেরিতে login_hint পাঠাবে।
প্রয়োজনীয়
২.৭ যখন ক্লাসরুম ব্যবহারকারী ইতিমধ্যেই অ্যাড-অনে সাইন ইন না করে থাকেন (লগইন ইঙ্গিত দেখে যা নির্ধারণ করা হয়), তখন অ্যাড-অনটিতে সাইন-ইন প্রক্রিয়াটি শুরু করার জন্য স্পষ্ট ব্যবহারকারীর পদক্ষেপের জন্য 'গুগলের সাথে সাইন-ইন করুন' বোতামটি উপস্থিত করতে হবে।
দ্রষ্টব্য : গুগল ব্র্যান্ডিং নির্দেশিকা পূরণের জন্য এটি প্রয়োজনীয় এবং পপ-আপ ব্লকার এড়াতেও সাহায্য করে।
প্রয়োজনীয়
২.৮ অ্যাড-অনটি বর্তমানে সাইন-ইন করা ব্যবহারকারী কে তা প্রদর্শন করবে। প্রস্তাবিত
৩.০ সাধারণ
৩.১ অ্যাড-অনটি অবশ্যই Google Workspace Marketplace অনুমোদনের সাধারণ নির্দেশিকা মেনে চলতে হবে। প্রয়োজনীয়
৩.২ যদি কোনও আইফ্রেম জার্নি থেকে কোনও টাস্ক একটি নতুন ট্যাব বা উইন্ডোতে চালু করা হয়, তবে এটি ক্লাসরুমে ফিরে যাওয়ার জন্য একটি ব্যবহারকারী-বান্ধব বার্তা প্রদান করবে। প্রস্তাবিত
৩.৩ ব্যবহারকারীকে শুধুমাত্র একটি অ্যাড-অন ওয়ার্কফ্লো ব্যবহার করে যাত্রাটি সম্পন্ন করতে হবে এবং কোনও কোর্সওয়ার্ক ফ্লোতে স্যুইচ করতে হবে না বা ক্লাসরুম শেয়ার বোতাম ব্যবহার করতে হবে না। প্রয়োজনীয়
৩.৪ স্থানীয়করণ পছন্দ: ভাষা উপলব্ধ থাকলে ব্রাউজার দ্বারা সেট করা স্থানীয় পছন্দের উপর ভিত্তি করে হওয়া উচিত। প্রস্তাবিত
৩.৫ যদি কোন অ্যাড-অন maxPoints সংজ্ঞায়িত করে, তাহলে এটি অবশ্যই pointsEarned সেট করবে যখন একজন শিক্ষার্থী সঞ্চিত শিক্ষক শংসাপত্র (প্রস্তাবিত) ব্যবহার করে একটি জমা সম্পূর্ণ করবে অথবা যখন শিক্ষক Student Work Review iframe-এ জমাটি খুলবেন। প্রয়োজনীয়
৩.৯ অ্যাড-অনগুলিকে অ্যাক্সেসিবিলিটি সম্পর্কিত WCAG 2.1 স্তরের AA নির্দেশিকা মেনে চলতে হবে। অ্যাড-অন ডেভেলপাররা স্ব-প্রতিবেদন করবেন যে জমা দেওয়ার সময় এই প্রয়োজনীয়তা পূরণ করা হয়েছে এবং অ্যাড-অনটি ভবিষ্যতে অ্যাড-অনে পরিবর্তনগুলির সাথে সঙ্গতিপূর্ণ থাকবে। প্রস্তাবিত
৩.১০ ব্যবহারকারীর যেকোনো ত্রুটি মানুষের পঠনযোগ্য হতে হবে। প্রস্তাবিত
৩.১১ যদি studentViewUri , teacherViewUri , অথবা studentWorkViewUri একটি কপি করা অ্যাসাইনমেন্ট বা কপি করা কোর্স থেকে চালু করা হয়, তাহলে অ্যাড-অনটি iframe-এ একটি ত্রুটি পৃষ্ঠা প্রদর্শন করবে না। প্রয়োজনীয়
৪.০ সংযুক্তি আবিষ্কার
৪.১ যদি কোনও সংযুক্তিতে শিক্ষার্থীর জমা দেওয়ার প্রয়োজন হয়, তাহলে সংযুক্তিতে অবশ্যই একটি studentWorkReviewUri অন্তর্ভুক্ত করতে হবে যাতে এটিকে একটি কার্যকলাপের ধরণ হিসেবে বিবেচনা করা হয়, বিষয়বস্তু ধরণের সংযুক্তি হিসেবে নয়। প্রয়োজনীয়
৪.২ অ্যাটাচমেন্ট ডিসকভারি আইফ্রেম অবশ্যই এমন একটি ইউজার ইন্টারফেস প্রদান করবে যা নিম্নলিখিতগুলির মধ্যে কমপক্ষে একটি অফার করবে:
  • সংযুক্ত করার জন্য নতুন কন্টেন্ট তৈরি করুন
  • একটি কন্টেন্ট লাইব্রেরি থেকে ব্রাউজ করুন, নির্বাচন করুন এবং সংযুক্ত করুন
  • আপনার ওয়েবসাইট বা অন্যান্য পণ্য থেকে কন্টেন্ট সংযুক্ত করার নির্দেশাবলী
প্রয়োজনীয়
৪.৩ শিক্ষকের কাছে উপলব্ধ সমস্ত বিষয়বস্তু/কার্যকলাপ খুঁজে পেতে এবং অ্যাক্সেস করতে সক্ষম হওয়া উচিত। প্রস্তাবিত
৪.৪ অ্যাসাইনমেন্টের সাথে সংযুক্ত করার প্রতিশ্রুতি দেওয়ার আগে শিক্ষককে বিষয়বস্তু/কার্যকলাপটি পূর্বরূপ দেখতে সক্ষম হতে হবে। প্রস্তাবিত
৪.৫ যদি শিক্ষকের দ্বারা কোনও কাজ সংযুক্ত করার আগে বিষয়বস্তু/কার্যকলাপ তৈরি করার প্রয়োজন হয়, তাহলে সেই কাজটি আইফ্রেমে সম্পন্ন করতে হবে। প্রস্তাবিত
৫.০ ছাত্রদের দৃষ্টিভঙ্গি
৫.১ যখন studentViewUri চালু করা হয়, তখন অ্যাড-অনটি কোনও কাজ সম্পন্ন করার জন্য ব্যবহারকারীকে আইফ্রেম থেকে বের করে দেওয়া উচিত নয়।
যদি অ্যাড-অনটি ব্যবহারকারীকে আইফ্রেম থেকে বের করে দেয়, তাহলে শিক্ষার্থীদের ক্লাসরুমে ফিরে যাওয়ার জন্য অবশ্যই একটি বার্তা বা অন্য কোনও ইঙ্গিত থাকতে হবে।
প্রস্তাবিত
৫.২ যদি আইফ্রেম থেকে কোনও অ্যাড-অন অ্যাক্টিভিটি পপ আউট হয়, তাহলে আইফ্রেমে টাস্ক সম্পর্কে একটি প্রিভিউ থাকা উচিত। প্রস্তাবিত
৫.৩ যদি থাকে, তাহলে "টার্ন ইন" লেবেলযুক্ত কার্যকলাপে একটি বোতাম বা লিঙ্ক উপস্থিত থাকলে, শিক্ষক পর্যালোচনার জন্য শিক্ষার্থীর কাজ জমা দেওয়ার জন্য একটি API অনুরোধ তৈরি করতে হবে। প্রয়োজনীয়
৬.০ শিক্ষকের দৃষ্টিভঙ্গি
৬.১ শিক্ষককে অবশ্যই দেখতে হবে যে শিক্ষার্থী যখন অ্যাসাইনমেন্টটি করবে তখন সে কী দেখবে। প্রস্তাবিত
৭.০ ছাত্রদের কাজের পর্যালোচনা
৭.১ যদি studentWorkReviewUri চালু করা হয়, তাহলে অ্যাড-অনটি অবশ্যই আইফ্রেমের মধ্যে শিক্ষক পর্যালোচনার জন্য শিক্ষার্থীর কাজ রেন্ডার করবে। পরিপূরক উপাদান আইফ্রেমের বাইরে লিঙ্ক করা যেতে পারে। প্রয়োজনীয়
৭.২ এই অ্যাড-অনটি studentWorkReviewUri ভিউতে শিক্ষার্থীদের মধ্যে নেভিগেশন সক্ষম করবে না। শিক্ষার্থীদের মধ্যে নেভিগেশন শুধুমাত্র ক্লাসরুম UI-তে হতে হবে। প্রয়োজনীয়
৮.০ শ্রেণীকক্ষ মোবাইল সহায়তা
৮.১ যখন Classroom মোবাইল অ্যাপটি teacherViewUri , studentViewUri অথবা studentWorkReviewUri চালু করে, তখন URLটি অবশ্যই পার্টনারের মোবাইল নেটিভ অ্যাপ অথবা পার্টনারের মোবাইল ওয়েব অ্যাপ খুলতে হবে, এবং উভয় ক্ষেত্রেই সঠিক ভিউতে ডিপ-লিঙ্ক করতে হবে। যদি ডিভাইসটি অসমর্থিত হয়, তাহলে ব্যবহারকারীকে একটি বার্তা প্রদর্শন করতে হবে যাতে তারা জানতে পারে যে এটি একটি অসমর্থিত ডিভাইস এবং আদর্শভাবে, কোন ডিভাইসগুলি সমর্থিত। প্রয়োজনীয়
৮.২ শিক্ষার্থীদের কাজ মোবাইল ডিভাইসে সম্পন্ন করা উচিত। প্রস্তাবিত
৯.০ অতিরিক্ত বৈশিষ্ট্য
৯.১ যদি শিক্ষকরা আপনার কন্টেন্টের লিঙ্কগুলিকে লিঙ্ক অ্যাটাচমেন্ট হিসেবে পেস্ট করতে পারেন, তাহলে আপনার লিঙ্কগুলিকে অ্যাড-অন অ্যাটাচমেন্টে আপগ্রেড করা উচিত। প্রস্তাবিত
৯.২ যদি আপনি ক্লাসরুমের বাইরে থেকে অ্যাসাইনমেন্ট তৈরি করতে CourseWork ইন্টিগ্রেশন ব্যবহার করেন, তাহলে আপনার অ্যাড-অনের সাথে সামঞ্জস্যপূর্ণ সমস্ত লিঙ্কের জন্য ডিফল্টরূপে অ্যাড-অন সংযুক্তি তৈরি করা উচিত। প্রস্তাবিত

পরিবর্তণ

সংস্করণ 1.1 ৫ ডিসেম্বর, ২০২৪ তারিখে আপডেট করা হয়েছে
১.১, ১.৩, ৩.২, ৩.১০, ৪.৪, ৫.২ REQUIRED থেকে RECOMMENDED এ পরিবর্তন করা হয়েছে।
৩.১২ সরানো হয়েছে।
৫.৩ রিওয়ার্ডেড। সাম্প্রতিক একটি পরিবর্তন অ্যাড-অন ডেভেলপারদের API ব্যবহার করে নির্ভরযোগ্যভাবে শিক্ষার্থীদের জমা দেওয়ার সুযোগ করে দিয়েছে।
সংস্করণ 1.0 ৩০ এপ্রিল, ২০২৪ তারিখে আপডেট করা হয়েছে
১.১ ১.১ এবং ১.২ কে একটি একক প্রয়োজনীয়তায় একত্রিত করা হয়েছে।
২.১ ২.১ এবং ২.৫ কে একটি একক প্রয়োজনীয়তায় একত্রিত করা হয়েছে।
২.২ ২.২, ২.৩, এবং ২.৪ কে একটি একক প্রয়োজনীয়তায় একত্রিত করা হয়েছে।
৩.৫ ৩.৫, ৩.৬, এবং ৩.৭ কে একটি একক প্রয়োজনীয়তায় একত্রিত করা হয়েছে।
৩.১০ অতিরিক্ত শর্ত হল যে অ্যাড-অনটি কখনই অবোধগম্য বা পুনরুদ্ধারযোগ্য অবস্থায় প্রবেশ করবে না।
৩.১১, ৩.১২ ৫.৫, ৫.৬, ৬.৩, ৬.৪, ৭.৫ এবং ৭.৬ কে দুটি নতুন প্রয়োজনীয়তায় একত্রিত করা হয়েছে।
৪.২ গ্রহণযোগ্য সংযুক্তি আবিষ্কারের অভিজ্ঞতার বর্ণনা প্রসারিত করা হয়েছে।
৪.৩ পুনঃসংখ্যাকরণ, পূর্বে 4.2। এছাড়াও REQUIRED থেকে RECOMMENDED এ পরিবর্তন করা হয়েছে।
৪.৪ পুনঃসংখ্যাকৃত, পূর্বে ৪.৩।
৪.৫ পুনঃসংখ্যাকৃত, পূর্বে ৪.৪।
৫.২ পুনঃসংখ্যাকৃত, পূর্বে ৫.৩।
৫.৩ পুনঃসংখ্যাকৃত, পূর্বে ৫.২।
৯.১ সংযুক্তিতে আটকানো লিঙ্কগুলি আপগ্রেড করার জন্য একটি সুপারিশ যোগ করা হয়েছে।
৯.২ কোর্সওয়ার্ক অ্যাসাইনমেন্ট প্রোগ্রাম্যাটিকভাবে তৈরি করার সময় ডিফল্টভাবে অ্যাড-অন সংযুক্তি তৈরি করার জন্য একটি সুপারিশ যোগ করা হয়েছে।
২.৬, ৩.৭, ৩.৮, ৬.২, ৭.৩, ৭.৪ সরানো হয়েছে।
সংস্করণ 0.3 আপডেট করা হয়েছে ২২ নভেম্বর, ২০২২
২.৩ লগইন ইঙ্গিত নির্দেশিকা সংশোধন।
২.৪ এমন একটি পরিস্থিতি অন্তর্ভুক্ত করা হয়েছে যেখানে hd বাস্তবায়ন প্রয়োজন।
৩.২ "পথ প্রদান করুন" শব্দটির পরিবর্তে ব্যবহার করা হয়েছে।
৫.৫, ৫.৬, ৬.৩, ৬.৪, ৭.৫, ৭.৬ studentViewUri , teacherViewUri , এবং studentWorkReviewUri জন্য প্রয়োজনীয় কোর্স কপি এবং প্রস্তাবিত নির্দেশিকা যোগ করা হয়েছে।
সংস্করণ 0.2 আপডেট করা হয়েছে ২৯ অক্টোবর, ২০২১
১.৩ উদ্দেশ্য আরও স্পষ্ট করার জন্য লেখাটি পরিবর্তন করা হয়েছে।
৩.১ "অ্যাড-অনটিকে অবশ্যই তাদের ওয়েবসাইটে পাওয়া সাধারণ GWM অনুমোদন নির্দেশিকা মেনে চলতে হবে।"
৩.৯ WCAG REQUIRED কে RECOMMENDED এ পরিবর্তন করা হয়েছে।
৫.১ REQUIRED কে RECOMMENDED এ পরিবর্তন করা হয়েছে।
৫.৩ "যদি অ্যাড-অনগুলি আইফ্রেম থেকে বেরিয়ে আসে, তাহলে আইফ্রেমে টাস্ক সম্পর্কে একটি প্রিভিউ থাকা আবশ্যক।" যোগ করা হয়েছে।
৫.৪ "যদি অ্যাড-অনটি আইফ্রেম থেকে বেরিয়ে আসে, তাহলে শিক্ষার্থীদের ক্লাসরুমে ফিরে যাওয়ার জন্য একটি প্রম্পট থাকা উচিত।" যোগ করা হয়েছে।
৮.১ "যদি ডিভাইসটি অসমর্থিত হয়, তাহলে ব্যবহারকারীকে একটি বার্তা প্রদর্শন করতে হবে যাতে তারা জানতে পারে যে এটি একটি অসমর্থিত ডিভাইস এবং আদর্শভাবে, কোন ডিভাইসগুলি সমর্থিত।"
৮.২ শিক্ষার্থীদের মোবাইল কাজ REQUIRED থেকে RECOMMENDED এ পরিবর্তন করা হয়েছে।
সংস্করণ 0.1 আপডেট করা হয়েছে ২২ সেপ্টেম্বর, ২০২১
প্রাথমিক প্রকাশ।