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

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

টেস্ট ডেপ্লয়মেন্ট ইনস্টল করার সময় এই ফিল্ডটি ঐচ্ছিক, কিন্তু ভার্সনযুক্ত ডেপ্লয়মেন্ট তৈরি করার সময় এটি আবশ্যক।

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

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

আপনার অনুমোদিত তালিকায় প্রিফিক্স যোগ করা

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

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

কোনো URL অনুমোদিত তালিকার (allowlist) কোনো প্রিফিক্সের সাথে মেলে কিনা তা নির্ধারণ করার ক্ষেত্রে নিম্নলিখিত নিয়মগুলি প্রযোজ্য:

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