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

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

ওভারভিউ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    • আপনি একাধিক URL প্যাটার্ন প্রদান করতে পারেন.
    • আপনি কোনো পাথ উপসর্গ প্রদান না করলে, হোস্টের সাথে মেলে এমন যেকোনো URL আপগ্রেড করা যেতে পারে।
    • শুধুমাত্র একটি https স্কিম সহ URLগুলি আপগ্রেড করা যেতে পারে৷
    • URL প্যাটার্নে localhost থাকা উচিত নয়।
    • পাথ প্রিফিক্সে অবশ্যই ক্যোয়ারী প্যারামিটার বা ইউআরএল ফ্র্যাগমেন্ট থাকবে না।
    • পাথ উপসর্গ এই সময়ে ওয়াইল্ডকার্ড সমর্থন করতে পারে, কিন্তু হোস্ট করতে পারে না:
      • 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/ এর সাথে মেলে না।

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

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

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

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

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

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

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

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

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