অনুমোদিত ইউআরএল

আপনার স্ক্রিপ্ট বা অ্যাড-অন দ্বারা অ্যাক্সেসের জন্য পূর্ব-অনুমোদিত নির্দিষ্ট ইউআরএলগুলিকে মনোনীত করতে আপনি অনুমতি তালিকা ব্যবহার করেন। অনুমোদিত তালিকাগুলি ব্যবহারকারীর ডেটা সুরক্ষিত করতে সহায়তা করে; আপনি যখন একটি অনুমোদিত তালিকা সংজ্ঞায়িত করেন, তখন স্ক্রিপ্ট প্রকল্পগুলি এমন URLগুলি অ্যাক্সেস করতে পারে না যেগুলি অনুমোদন তালিকায় যোগ করা হয়নি৷

আপনি একটি পরীক্ষা স্থাপনা ইনস্টল করার সময় এই ক্ষেত্রটি ঐচ্ছিক, কিন্তু যখন আপনি একটি সংস্করণযুক্ত স্থাপনা তৈরি করেন তখন এটি প্রয়োজনীয়।

যখন আপনার স্ক্রিপ্ট বা অ্যাড-অন নিম্নলিখিত কাজগুলি সম্পাদন করে তখন আপনি অনুমোদিত তালিকা ব্যবহার করেন:

  • Apps Script UrlFetch পরিষেবা ব্যবহার করে একটি বাহ্যিক অবস্থান (যেমন HTTPS এন্ডপয়েন্ট) থেকে তথ্য পুনরুদ্ধার বা আনয়ন করে। আনার জন্য ইউআরএলগুলিকে অনুমতি দিতে, আপনার ম্যানিফেস্ট ফাইলে urlFetchWhitelist ক্ষেত্রটি অন্তর্ভুক্ত করুন।
  • ব্যবহারকারীর ক্রিয়াকলাপের প্রতিক্রিয়া হিসাবে একটি URL খোলে বা প্রদর্শন করে (Google Workspace অ্যাড-অনগুলির জন্য প্রয়োজনীয় যা Google-এর বাইরের ইউআরএলগুলি খোলে বা প্রদর্শন করে)। ইউআরএল খোলার অনুমতি দিতে, আপনার ম্যানিফেস্ট ফাইলে addOns.common.openLinkUrlPrefixes ফিল্ড অন্তর্ভুক্ত করুন।

আপনার অনুমোদিত তালিকায় উপসর্গ যোগ করা হচ্ছে

যখন আপনি আপনার ম্যানিফেস্ট ফাইলে ( addOns.common.openLinkUrlPrefixes বা urlFetchWhitelist ফিল্ড অন্তর্ভুক্ত করে) অনুমতি তালিকা নির্দিষ্ট করেন, তখন আপনাকে অবশ্যই URL প্রিফিক্সের একটি তালিকা অন্তর্ভুক্ত করতে হবে। আপনি ম্যানিফেস্টে যে উপসর্গগুলি যোগ করবেন সেগুলি অবশ্যই নিম্নলিখিত প্রয়োজনীয়তাগুলি পূরণ করবে:

  • প্রতিটি উপসর্গ একটি বৈধ URL হতে হবে।
  • প্রতিটি উপসর্গ অবশ্যই https:// ব্যবহার করবে, http:// নয়।
  • প্রতিটি উপসর্গের একটি সম্পূর্ণ ডোমেন থাকতে হবে।
  • প্রতিটি উপসর্গের একটি অ-খালি পথ থাকতে হবে। উদাহরণস্বরূপ, https://www.google.com/ বৈধ কিন্তু https://www.google.com নয়৷
  • ইউআরএল সাবডোমেন প্রিফিক্সের সাথে মেলে ওয়াইল্ডকার্ড ব্যবহার করতে পারেন।
  • একটি একক * ওয়াইল্ডকার্ড ব্যবহার করা যেতে পারে addOns.common.openLinkUrlPrefixes ফিল্ডে সমস্ত লিঙ্কের সাথে মেলে, কিন্তু এটি সুপারিশ করা হয় না কারণ এটি একটি ব্যবহারকারীর ডেটাকে ঝুঁকিতে ফেলতে পারে এবং অ্যাড-অন পর্যালোচনা প্রক্রিয়াকে দীর্ঘায়িত করতে পারে। আপনার অ্যাড-অন কার্যকারিতা প্রয়োজন হলে শুধুমাত্র একটি ওয়াইল্ডকার্ড ব্যবহার করুন।

ইউআরএল অনুমোদিত তালিকার উপসর্গের সাথে মেলে কিনা তা নির্ধারণ করার সময়, নিম্নলিখিত নিয়মগুলি প্রযোজ্য:

  • পাথ ম্যাচিং কেস-সংবেদনশীল।
  • যদি উপসর্গটি URL-এর সাথে অভিন্ন হয় তবে এটি একটি মিল।
  • ইউআরএল একই বা উপসর্গের একটি শিশু হলে, এটি একটি মিল।

উদাহরণস্বরূপ, https://example.com/foo উপসর্গ নিম্নলিখিত URLগুলির সাথে মেলে:

  • https://example.com/foo
  • https://example.com/foo/
  • https://example.com/foo/bar
  • https://example.com/foo?bar
  • https://example.com/foo#bar

ওয়াইল্ডকার্ড ব্যবহার করে

আপনি urlFetchWhitelist এবং addOns.common.openLinkUrlPrefixes উভয় ক্ষেত্রের জন্য একটি সাবডোমেনের সাথে মেলে একটি একক ওয়াইল্ডকার্ড অক্ষর ( * ) ব্যবহার করতে পারেন৷ আপনি একাধিক সাবডোমেনের সাথে মেলে একাধিক ওয়াইল্ডকার্ড ব্যবহার করতে পারবেন না এবং ওয়াইল্ডকার্ডটি অবশ্যই URL-এর অগ্রণী উপসর্গের প্রতিনিধিত্ব করবে৷

উদাহরণস্বরূপ, উপসর্গ https://*.example.com/foo নিম্নলিখিত URLগুলির সাথে মেলে:

  • https://subdomain.example.com/foo
  • https://any.number.of.subdomains.example.com/foo

https://*.example.com/foo উপসর্গটি নিম্নলিখিত URLগুলির সাথে মেলে না :

  • https://subdomain.example.com/bar (প্রত্যয় অমিল)
  • https://example.com/foo (অন্তত একটি সাবডোমেন উপস্থিত থাকতে হবে)

আপনি যখন আপনার ম্যানিফেস্ট সংরক্ষণ করার চেষ্টা করেন তখন কিছু প্রিফিক্স নিয়ম প্রয়োগ করা হয়। উদাহরণস্বরূপ, আপনি সংরক্ষণ করার চেষ্টা করার সময় নিম্নলিখিত উপসর্গগুলি আপনার ম্যানিফেস্টে উপস্থিত থাকলে একটি ত্রুটি সৃষ্টি করে:

  • https://*.*.example.com/foo (একাধিক ওয়াইল্ডকার্ড নিষিদ্ধ)
  • https://subdomain.*.example.com/foo (ওয়াইল্ডকার্ড একটি অগ্রণী উপসর্গ হিসাবে ব্যবহার করা আবশ্যক)