স্কোপ, স্কোপ, স্কোপ

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

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

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

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

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

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

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

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

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

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

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

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

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

   {
     ...
     "oauthScopes": [
       "https://www.googleapis.com/auth/gmail.addons.current.message.metadata",
       "https://www.googleapis.com/auth/userinfo.email"
     ],
     ...
   }
   

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

OAuth যাচাইকরণ

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

• অ্যাপস স্ক্রিপ্টের জন্য OAuth ক্লায়েন্ট যাচাইকরণ
• যাচাই না করা অ্যাপ
• OAuth যাচাইকরণের প্রায়শই জিজ্ঞাসিত প্রশ্নাবলী
• গুগল এপিআই পরিষেবা: ব্যবহারকারীর ডেটা নীতি

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

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

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

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

Google Workspace অ্যাড-অনের জন্য স্কোপ বেছে নিন

নিম্নলিখিত বিভাগগুলিতে Google Workspace অ্যাড-অনের জন্য সাধারণত ব্যবহৃত স্কোপগুলি প্রদান করা হয়েছে।

সম্পাদকের সুযোগ

নিচে Google Workspace অ্যাড-অনগুলির জন্য প্রায়শই ব্যবহৃত স্কোপগুলি দেওয়া হল যা Docs, Sheets এবং Slides প্রসারিত করে।

জিমেইল

ব্যবহারকারীর জিমেইল ডেটা সুরক্ষিত রাখতে Google Workspace অ্যাড-অনগুলির জন্য বিশেষভাবে তৈরি করা কিছু স্কোপ রয়েছে। আপনার অ্যাড-অন কোডের জন্য প্রয়োজনীয় অন্যান্য স্কোপগুলির সাথে, আপনাকে অবশ্যই এই স্কোপগুলি আপনার অ্যাড-অন ম্যানিফেস্টে স্পষ্টভাবে যোগ করতে হবে।

নিচে Google Workspace অ্যাড-অনগুলির জন্য প্রায়শই ব্যবহৃত স্কোপগুলি দেওয়া হল যা Gmail প্রসারিত করে; যদি আপনার অ্যাড-অন Gmail প্রসারিত করে তবে Required লেবেলযুক্ত স্কোপগুলি আপনার Google Workspace অ্যাড-অন ম্যানিফেস্টে যোগ করতে হবে।

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

গুগল ক্যালেন্ডার স্কোপ

নিচে Google Workspace অ্যাড-অনগুলির জন্য প্রায়শই ব্যবহৃত স্কোপগুলি দেওয়া হল যা Google ক্যালেন্ডারকে প্রসারিত করে।

গুগল চ্যাট স্কোপ

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

চ্যাট স্কোপ এবং প্রমাণীকরণের ধরণ সম্পর্কে আরও জানতে, চ্যাট API প্রমাণীকরণ এবং অনুমোদনের ওভারভিউ দেখুন।

নিম্নলিখিত টেবিলে সমর্থিত প্রমাণীকরণের ধরণের উপর ভিত্তি করে প্রায়শই ব্যবহৃত চ্যাট API পদ্ধতি এবং স্কোপ দেখানো হয়েছে:

গুগল ড্রাইভ স্কোপ

নিচে Google Workspace অ্যাড-অনগুলির জন্য প্রায়শই ব্যবহৃত স্কোপগুলি দেওয়া হল যা Google Drive প্রসারিত করে।

অ্যাক্সেস টোকেন

ব্যবহারকারীর ডেটা সুরক্ষিত রাখার জন্য, Google Workspace অ্যাড-অনগুলিতে ব্যবহৃত Gmail স্কোপগুলি শুধুমাত্র ব্যবহারকারীর ডেটাতে অস্থায়ী অ্যাক্সেস দেয়। অস্থায়ী অ্যাক্সেস সক্ষম করতে, আপনাকে একটি অ্যাক্সেস টোকেন ব্যবহার করে একটি আর্গুমেন্ট হিসাবে GmailApp.setCurrentMessageAccessToken(accessToken) ফাংশনটি কল করতে হবে। আপনাকে একটি অ্যাকশন ইভেন্ট অবজেক্ট থেকে একটি অ্যাক্সেস টোকেন পেতে হবে।

নিম্নলিখিতটি একটি বার্তার মেটাডেটা অ্যাক্সেসের অনুমতি দেওয়ার জন্য একটি অ্যাক্সেস টোকেন সেট করার একটি উদাহরণ দেখায়। এই উদাহরণের জন্য প্রয়োজনীয় একমাত্র সুযোগ হল https://www.googleapis.com/auth/gmail.addons.current.message.metadata ।

function readSender(e) {
  var accessToken = e.gmail.accessToken;
  var messageId = e.gmail.messageId;

  // The following function enables short-lived access to the current
  // message in Gmail. Access to other Gmail messages or data isn't
  // permitted.
  GmailApp.setCurrentMessageAccessToken(accessToken);
  var mailMessage = GmailApp.getMessageById(messageId);
  return mailMessage.getFrom();
}

অন্যান্য Google Workspace স্কোপ

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

নিম্নলিখিত টেবিলে Google Workspace অ্যাড-অনগুলি প্রায়শই ব্যবহার করে এমন স্কোপের একটি তালিকা দেখানো হয়েছে: