এডিটর অ্যাড-অনগুলির জন্য অনুমোদনের সুযোগ, সম্পাদক অ্যাড-অনগুলির জন্য অনুমোদনের সুযোগ, সম্পাদক অ্যাড-অনগুলির জন্য অনুমোদনের সুযোগ

ব্যবহারকারীদের অবশ্যই অ্যাড-অন এবং অন্যান্য অ্যাপ্লিকেশনগুলিকে অনুমোদন করতে হবে যারা তাদের ডেটা অ্যাক্সেস করে বা তাদের পক্ষে কাজ করে। যখন কোনও ব্যবহারকারী প্রথমবারের জন্য একটি অ্যাড-অন চালায়, তখন অ্যাড-অন UI অনুমোদন প্রবাহ শুরু করার জন্য একটি অনুমোদন প্রম্পট উপস্থাপন করে।

এই প্রবাহের সময়, প্রম্পট ব্যবহারকারীকে বলে যে অ্যাপ্লিকেশনটি কী করার অনুমতি চায়। উদাহরণস্বরূপ, একটি অ্যাড-অন ব্যবহারকারীর ইমেল বার্তা পড়ার জন্য বা তাদের ক্যালেন্ডারে ইভেন্ট তৈরি করার জন্য অনুমতি চাইতে পারে। অ্যাড-অনের স্ক্রিপ্ট প্রকল্প এই পৃথক অনুমতিগুলিকে OAuth scopes হিসাবে সংজ্ঞায়িত করে।

আপনি আপনার ম্যানিফেস্টে URL স্ট্রিং ব্যবহার করে স্কোপ ঘোষণা করেন। অনুমোদন প্রবাহের সময়, অ্যাপস স্ক্রিপ্ট ব্যবহারকারীর কাছে স্কোপের একটি মানব-পঠনযোগ্য বর্ণনা উপস্থাপন করে। উদাহরণস্বরূপ, আপনার অ্যাড-অন "বর্তমান ডকুমেন্ট পড়ুন" স্কোপ ব্যবহার করতে পারে, যা আপনার ম্যানিফেস্টে https://www.googleapis.com/auth/documents.currentonly হিসাবে লেখা আছে। অনুমোদন প্রবাহের সময়, এই স্কোপের একটি অ্যাড-অন ব্যবহারকারীকে অ্যাড-অনকে নিম্নলিখিতগুলি করতে অনুমতি দিতে বলে: এই অ্যাপ্লিকেশনটি ইনস্টল করা ডকুমেন্টগুলি দেখুন এবং পরিচালনা করুন।

স্কোপ দেখা হচ্ছে

আপনার স্ক্রিপ্ট প্রকল্পের বর্তমানে প্রয়োজনীয় স্কোপগুলি আপনি নিম্নলিখিতগুলি করে দেখতে পারেন:

  1. স্ক্রিপ্ট প্রজেক্টটি খুলুন।
  2. বাম দিকে, ওভারভিউ ক্লিক করুন।
  3. "প্রজেক্ট OAuth স্কোপ" এর অধীনে স্কোপগুলি দেখুন।

আপনি oauthScopes ক্ষেত্রের অধীনে প্রজেক্ট ম্যানিফেস্টে স্ক্রিপ্ট প্রজেক্টের বর্তমান স্কোপগুলিও দেখতে পারেন, তবে শুধুমাত্র যদি আপনি সেই স্কোপগুলি স্পষ্টভাবে সেট করে থাকেন।

স্পষ্ট সুযোগ নির্ধারণ করা হচ্ছে

অ্যাপস স্ক্রিপ্ট স্বয়ংক্রিয়ভাবে নির্ধারণ করে যে কোন স্ক্রিপ্টের কোন স্কোপের প্রয়োজন, এর কোড স্ক্যান করে, যে ফাংশন কলগুলির প্রয়োজন হয়। বেশিরভাগ স্ক্রিপ্টের জন্য এটি যথেষ্ট এবং আপনার সময় সাশ্রয় করে, তবে প্রকাশিত অ্যাড-অনের জন্য আপনার স্কোপের উপর আরও সরাসরি নিয়ন্ত্রণ ব্যবহার করা উচিত।

উদাহরণস্বরূপ, অ্যাপস স্ক্রিপ্ট একটি অ্যাড-অন স্ক্রিপ্ট প্রকল্পকে ডিফল্টরূপে https://mail.google.com খুব অনুমতিমূলক সুযোগ দিতে পারে। যখন একজন ব্যবহারকারী এই সুযোগের সাথে একটি স্ক্রিপ্ট প্রকল্পকে অনুমোদন করেন, তখন প্রকল্পটি ব্যবহারকারীর Gmail অ্যাকাউন্টে সম্পূর্ণ অ্যাক্সেস পায়। প্রকাশিত অ্যাড-অনের জন্য, আপনাকে এই সুযোগটি আরও সীমিত সেট দিয়ে প্রতিস্থাপন করতে হবে যা অ্যাড-অনের চাহিদা পূরণ করে এবং এর বেশি কিছু নয়।

আপনার স্ক্রিপ্ট প্রজেক্টের ম্যানিফেস্ট ফাইল সম্পাদনা করে আপনি স্পষ্টভাবে স্কোপগুলি সেট করতে পারেন। ম্যানিফেস্ট ফিল্ড oauthScopes হল অ্যাড-অন দ্বারা ব্যবহৃত সমস্ত স্কোপের একটি অ্যারে। আপনার প্রজেক্টের স্কোপগুলি সেট করতে, নিম্নলিখিতগুলি করুন:

  1. আপনার অ্যাড-অন বর্তমানে কোন স্কোপগুলি ব্যবহার করে তা দেখুন । কোন পরিবর্তনগুলি করা প্রয়োজন তা নির্ধারণ করুন, যেমন একটি সংকীর্ণ স্কোপ ব্যবহার করা।
  2. আপনার অ্যাড-অনের ম্যানিফেস্ট ফাইলটি খুলুন ।
  3. oauthScopes লেবেলযুক্ত শীর্ষ-স্তরের ক্ষেত্রটি খুঁজুন। যদি এটি উপস্থিত না থাকে, তাহলে আপনি এটি যোগ করতে পারেন।

  4. oauthScopes ক্ষেত্রটি স্ট্রিংগুলির একটি অ্যারে নির্দিষ্ট করে। আপনার প্রকল্পের ব্যবহৃত স্কোপগুলি সেট করতে, এই অ্যারের বিষয়বস্তুগুলিকে আপনি যে স্কোপগুলি ব্যবহার করতে চান তার সাথে প্রতিস্থাপন করুন। উদাহরণস্বরূপ, একটি সম্পাদক অ্যাড-অনের জন্য যা Sheets প্রসারিত করে, আপনার নিম্নলিখিতগুলি থাকতে পারে:

    {
  ...
  "oauthScopes": [
    "https://www.googleapis.com/auth/script.container.ui",
    "https://www.googleapis.com/auth/spreadsheets"
  ],
  ...
}

  5. ম্যানিফেস্ট ফাইলের পরিবর্তনগুলি সংরক্ষণ করুন।

OAuth যাচাইকরণ

কিছু সংবেদনশীল OAuth স্কোপ ব্যবহার করার জন্য আপনার অ্যাড-অন প্রকাশ করার আগে OAuth ক্লায়েন্ট যাচাইকরণের প্রয়োজন হতে পারে। আরও তথ্যের জন্য, নিম্নলিখিত নির্দেশিকাগুলি দেখুন:

সীমাবদ্ধ সুযোগ

কিছু স্কোপ সীমাবদ্ধ এবং অতিরিক্ত নিয়মের আওতায় থাকে যা ব্যবহারকারীর ডেটা সুরক্ষিত রাখতে সাহায্য করে। যদি আপনি এমন একটি Gmail বা Editor অ্যাড-অন প্রকাশ করতে চান যা এক বা একাধিক সীমাবদ্ধ স্কোপ ব্যবহার করে, তাহলে অ্যাড-অনটি প্রকাশ করার আগে অবশ্যই সমস্ত নির্দিষ্ট বিধিনিষেধ মেনে চলতে হবে।

প্রকাশ করার চেষ্টা করার আগে সীমাবদ্ধ স্কোপের সম্পূর্ণ তালিকা পর্যালোচনা করুন। যদি আপনার অ্যাড-অন এগুলির কোনওটি ব্যবহার করে, তাহলে প্রকাশের আগে আপনাকে নির্দিষ্ট API স্কোপের জন্য অতিরিক্ত প্রয়োজনীয়তাগুলি মেনে চলতে হবে।

ভিজ্যুয়াল স্টুডিও কোডের জন্য গুগল ওয়ার্কস্পেস ডেভেলপার টুলস এক্সটেনশনটি সমস্ত স্কোপের জন্য ডায়াগনস্টিক তথ্য প্রদান করে, যার মধ্যে স্কোপের বিবরণ এবং এটি সংবেদনশীল নাকি সীমাবদ্ধ তা অন্তর্ভুক্ত রয়েছে।

সম্পাদক অ্যাড-অন স্কোপ

যখন আপনি একটি এডিটর অ্যাড-অন তৈরি করেন, তখন প্রয়োজনীয় স্কোপগুলি অ্যাপস স্ক্রিপ্ট পরিষেবা এবং অ্যাড-অন কোডের ব্যবহৃত পদ্ধতি দ্বারা নির্ধারিত হয়। উদাহরণস্বরূপ, বিভিন্ন গুগল শিট থেকে তথ্য পড়ার জন্য একটি শীট অ্যাড-অনের https://www.googleapis.com/auth/spreadsheets.readonly স্কোপের প্রয়োজন হতে পারে।

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

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

  /**
   * @OnlyCurrentDoc
   */

এই মন্তব্যটি Apps Script কে এডিটর ফাইলের স্কোপগুলিকে currentonly এ সংকুচিত করতে বলে। উদাহরণস্বরূপ, যদি আপনি এই মন্তব্যটি একটি Google Sheets অ্যাড-অন স্ক্রিপ্ট প্রজেক্ট ফাইলে যোগ করেন, তাহলে আপনি উল্লেখ করছেন যে অ্যাড-অনটির শুধুমাত্র বর্তমানে খোলা শীটে কাজ করার অনুমতি প্রয়োজন, এবং Google ড্রাইভে ব্যবহারকারীর থাকা অন্য কোনও শীটে নয়। বিপরীতভাবে, যদি আপনার Sheets অ্যাড-অনটি এমন একটি শীটে ডেটা পড়তে বা লিখতে চায় যা ব্যবহারকারী বর্তমানে খোলেননি, তাহলে আপনার এই মন্তব্যটি ব্যবহার করা উচিত নয়।