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

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

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

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

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

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

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

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

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

এই অংশে ফিচারটির কিছু গুরুত্বপূর্ণ প্রযুক্তিগত বিবরণ তুলে ধরা হয়েছে।

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

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

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

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

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

  • লিঙ্ক আপগ্রেড আইফ্রেমের ইউআরএল : কোনো শিক্ষক আপগ্রেড করতে সম্মত হলে এই ইউআরএলটি আইফ্রেমে খোলে।

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

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

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

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

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

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

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

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

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

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

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

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

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