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

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

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

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

দেখার সুযোগ

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

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

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

সুস্পষ্ট সুযোগ সেট করা

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

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

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

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

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

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

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

OAuth যাচাইকরণ

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

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

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

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

এডিটর অ্যাড-অন স্কোপ

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

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

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

  /**
   * @OnlyCurrentDoc
   */

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