ক্লাসরুম অ্যাড-অন সংযুক্তিতে লিঙ্ক সংযুক্তি আপগ্রেড করুন

শিক্ষকরা ক্লাসরুমে তৃতীয় পক্ষের কন্টেন্ট যোগ করার একটি উপায় হল অ্যাসাইনমেন্ট তৈরির পৃষ্ঠায় একটি লিঙ্ক সংযুক্তি হিসেবে পেস্ট করা। শিক্ষকরা ইতিমধ্যে যা জানেন তার উপর ভিত্তি করে তৈরি করতে, আপনি এখন আপনার অ্যাড-অন কনফিগার করতে পারেন যাতে শিক্ষকরা একটি লিঙ্ক সংযুক্তি একটি অ্যাড-অন সংযুক্তিতে আপগ্রেড করতে পারেন।

সংক্ষিপ্ত বিবরণ

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

শিক্ষক একবার লিঙ্কটি একটি অ্যাড-অন সংযুক্তিতে আপগ্রেড করতে সম্মত হলে, লিঙ্ক আপগ্রেড আইফ্রেম নিম্নলিখিত কোয়েরি প্যারামিটার সহ চালু করা হয়:

  • courseId
  • itemId
  • itemType
  • addOnToken
  • urlToUpgrade
  • login_hint (শুধুমাত্র যদি ব্যবহারকারী ইতিমধ্যেই আপনার অ্যাপটি অনুমোদিত করে থাকেন)

প্রথম চারটি কোয়েরি প্যারামিটার Attachment Discovery iframe- এ চালু হওয়া কোয়েরি প্যারামিটারের সাথে মিলে যায়। urlToUpgrade কোয়েরি প্যারামিটারটি নতুন এবং অ্যাড-অন অ্যাটাচমেন্টটি কীভাবে তৈরি করা উচিত তা মূল্যায়ন করতে আপনাকে সাহায্য করতে পারে। তারপর, আপনি অন্যান্য কোয়েরি প্যারামিটারগুলি ব্যবহার করে ব্যবহারকারী সাইন-ইন করেছেন কিনা তা পরীক্ষা করতে পারেন এবং courseWork , courseWorkMaterials বা itemType মানের উপর ভিত্তি করে announcements CreateAddOnAttachment পদ্ধতিতে কল করতে পারেন। iframe-এর মধ্যে, আপনি শিক্ষককে নির্দেশ করার জন্য একটি লোডিং স্ক্রিন প্রদর্শন করতে পারেন যে অ্যাড-অন অ্যাটাচমেন্টটি তৈরি করা হচ্ছে।

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

প্রযুক্তিগত বাস্তবায়নের বিবরণ

এই বিভাগে বৈশিষ্ট্যটির কিছু গুরুত্বপূর্ণ প্রযুক্তিগত বিবরণ তুলে ধরা হয়েছে।

urlToUpgrade কোয়েরি প্যারামিটারটি পড়ুন

urlToUpgrade কোয়েরি প্যারামিটারটি যখন Link Upgrade iframe-এ পাস করা হয় তখন URI এনকোড করা হয়। URLটিকে তার আসল আকারে পেতে আপনাকে অবশ্যই ডিকোড করতে হবে। উদাহরণস্বরূপ, যদি আপনি জাভাস্ক্রিপ্ট ব্যবহার করেন, তাহলে আপনি decodeURIComponent() ফাংশনটি ব্যবহার করতে পারেন।

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

কনফিগারেশনের বিশদ বিবরণ

আপনার অ্যাড-অনে এই বৈশিষ্ট্যটি সংহত করার জন্য নিম্নলিখিত কনফিগারেশনগুলি প্রয়োজন:

  • লিংক আপগ্রেড আইফ্রেমের URL : যখন একজন শিক্ষক আপগ্রেড করতে সম্মত হন তখন আইফ্রেমে এটিই খোলা URL।

  • ক্লাসরুমের যেসব URL প্যাটার্ন সনাক্ত করা উচিত এবং আপগ্রেড করার চেষ্টা করা উচিত : URL প্যাটার্নগুলিতে একটি হোস্ট এবং একাধিক পাথ প্রিফিক্স থাকতে পারে।

    • আপনি একাধিক URL প্যাটার্ন প্রদান করতে পারেন।
    • যদি আপনি কোনও পাথ প্রিফিক্স প্রদান না করেন, তাহলে হোস্টের সাথে মেলে এমন যেকোনো URL আপগ্রেড করা যেতে পারে।
    • শুধুমাত্র https স্কিম সহ URL গুলি আপগ্রেড করা যাবে।
    • URL প্যাটার্নে localhost থাকা উচিত নয়।
    • পাথ প্রিফিক্সগুলিতে কোয়েরি প্যারামিটার বা URL টুকরো থাকা উচিত নয়।
    • এই সময়ে পাথ প্রিফিক্সগুলি ওয়াইল্ডকার্ড সমর্থন করতে পারে, কিন্তু হোস্টগুলি পারে না:
      • example.com একটি বৈধ হোস্ট, এবং /foo এবং /bar/*/baz হল বৈধ পাথ প্রিফিক্স।
      • example.*.host.com একটি বৈধ হোস্ট নয়।
    • পাথ প্রিফিক্স কম্পোনেন্টের মধ্যে একটি ওয়াইল্ডকার্ড শুধুমাত্র একটি একক কম্পোনেন্টের সাথে মেলে, এবং স্ল্যাশ দ্বারা পৃথক করা একাধিক কম্পোনেন্টের সাথে মেলে না। হোস্ট example.com এবং পাথ প্রিফিক্স /bar/*/baz সহ একটি URL প্যাটার্ন বিবেচনা করুন:
      • https://example.com/bar/123/baz হল URL প্যাটার্নের জন্য একটি বৈধ মিল।
      • https://example.com/bar/123/baz/456/789 হল URL প্যাটার্নের জন্য একটি বৈধ মিল।
      • https://example.com/bar/123/456/baz URL প্যাটার্নের জন্য একটি বৈধ মিল নয় কারণ পাথ প্রিফিক্সের ওয়াইল্ডকার্ড /123/456/ সাথে মেলে না।

উন্নয়ন প্রক্রিয়া

আপনার পরীক্ষা বা প্রোডাকশন অ্যাড-অনের জন্য লিঙ্ক আপগ্রেড আইফ্রেম URL এবং URL প্যাটার্নগুলি classroom-link-upgrade-external@google.com ইমেল করে পাঠান।

আপনি যেকোনো Google Cloud প্রকল্পের জন্য কনফিগারেশন প্রদান করতে পারেন যা একটি Classroom অ্যাড-অন উপস্থাপন করে। আমরা আপনাকে প্রথমে ব্যক্তিগত দৃশ্যমানতা সহ একটি অ্যাড-অনের জন্য কনফিগারেশন প্রদান করার পরামর্শ দিচ্ছি যাতে আপনি লাইভ ব্যবহারকারীদের প্রভাবিত না করেই একটি ডেমো ডোমেনে ডেভেলপ এবং পরীক্ষা করতে পারেন।

কনফিগারেশনগুলি সক্রিয় হয়ে গেলে আপনি আপনার ইমেলের একটি প্রতিক্রিয়া পাবেন। মনে রাখবেন যে localhost ব্যবহার করে এমন URL প্যাটার্নগুলি এই বৈশিষ্ট্যের জন্য সমর্থিত নয়।

নিম্নলিখিতগুলি অন্তর্ভুক্ত করে ইমেলটি ফর্ম্যাট করুন:

Google Cloud Project number: GCP_PROJECT_NUMBER

Link Upgrade iframe URL: LINK_UPGRADE_IFRAME_URL

URL Patterns:
-   Host:HOST_1
-   Path prefixes:
  -   PATH_PREFIX_1
  -   PATH_PREFIX_2

-   Host:HOST_2
-   Path prefixes:
  -   PATH_PREFIX_3
  -   PATH_PREFIX_4

// add more hosts and path prefixes as needed

নিম্নলিখিতগুলি প্রতিস্থাপন করুন:

  • GCP_PROJECT_NUMBER : অ্যাড-অনটি যে Google ক্লাউড প্রোজেক্টের সাথে যুক্ত তার সংখ্যা।
  • LINK_UPGRADE_IFRAME_URL : লিঙ্ক আপগ্রেড আইফ্রেমে যে URLটি খুলবে।
  • HOST_1 : এমন একটি হোস্ট যা Classroom সনাক্ত করবে। শুধুমাত্র https স্কিমটি সমর্থিত।
  • PATH_PREFIX_1 এবং PATH_PREFIX_2 : HOST_1 সাথে সম্পর্কিত পাথ প্রিফিক্স যা ক্লাসরুমের সনাক্ত করা উচিত এবং আপগ্রেড করার চেষ্টা করা উচিত।
  • HOST_2 : এমন একটি হোস্ট যা Classroom সনাক্ত করবে। শুধুমাত্র https স্কিমটি সমর্থিত।
  • PATH_PREFIX_3 এবং PATH_PREFIX_4 : HOST_2 সাথে সম্পর্কিত পাথ প্রিফিক্স যা ক্লাসরুমের সনাক্ত করা উচিত এবং আপগ্রেড করার চেষ্টা করা উচিত।

এই বৈশিষ্ট্যটি বাস্তবায়নের সময় নিম্নলিখিত পরামর্শগুলি বিবেচনা করা উচিত।

শিক্ষকদের অতিরিক্ত কাজ এড়িয়ে চলুন

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

ব্যবহারকারী-বান্ধব অ্যাক্সেস ত্রুটি বার্তা অন্তর্ভুক্ত করুন

যদি শিক্ষকরা এমন কোনও লিঙ্ক পেস্ট এবং আপগ্রেড করেন যা তাদের অ্যাক্সেস নেই, তাহলে আইফ্রেমে একটি ব্যবহারকারী-বান্ধব ত্রুটি বার্তা প্রদর্শন করুন যাতে শিক্ষকরা সমস্যাটি সম্পর্কে সচেতন হন। আইফ্রেমটি শিক্ষককে সামগ্রী অ্যাক্সেস করার জন্য উপযুক্ত অনুমতি প্রদানের জন্যও ব্যবহার করা যেতে পারে।