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

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

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

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

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

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

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

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

কোনও URL অ্যালাউলিস্টের কোনও প্রিফিক্সের সাথে মেলে কিনা তা নির্ধারণ করার সময়, নিম্নলিখিত নিয়মগুলি প্রযোজ্য হয়:

  • পাথ ম্যাচিং কেস-সংবেদনশীল।
  • যদি উপসর্গটি URL-এর সাথে অভিন্ন হয়, তাহলে এটি একটি মিল।
  • যদি 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 (ওয়াইল্ডকার্ড অবশ্যই লিডিং প্রিফিক্স হিসেবে ব্যবহার করতে হবে)