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

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

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

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

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

দেখার সুযোগ

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

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

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

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

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

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

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

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

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

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

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

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

OAuth যাচাইকরণ

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

• Apps স্ক্রিপ্টের জন্য OAuth ক্লায়েন্ট যাচাইকরণ
• যাচাইকৃত অ্যাপস
• OAuth যাচাইকরণ FAQ
• Google APIs পরিষেবা: ব্যবহারকারীর ডেটা নীতি

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

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

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

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

Google Workspace অ্যাড-অনগুলির জন্য সুযোগগুলি বেছে নিন

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

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

নীচে Google Workspace অ্যাড-অনগুলির জন্য ঘন ঘন ব্যবহার করা সুযোগ রয়েছে যা ডক্স, পত্রক এবং স্লাইডগুলিকে প্রসারিত করে।

দ্রষ্টব্য: currentonly সুযোগ শুধুমাত্র Apps স্ক্রিপ্ট পরিষেবার মধ্যে উপলব্ধ. এর মধ্যে Apps Script Advanced Services বা Google Workspace API-তে সরাসরি কল অন্তর্ভুক্ত নেই।

ব্যাপ্তি
বর্তমান ডক্স ফাইল অ্যাক্সেস	https://www.googleapis.com/auth/documents.currentonly অ্যাড-অন অ্যাপস স্ক্রিপ্ট ডক্স এপিআই অ্যাক্সেস করলে প্রয়োজনীয়। খোলা নথির সামগ্রীতে অস্থায়ী অ্যাক্সেস মঞ্জুর করে৷
বর্তমান পত্রক ফাইল অ্যাক্সেস	https://www.googleapis.com/auth/spreadsheets.currentonly অ্যাড-অন অ্যাপস স্ক্রিপ্ট শীট API অ্যাক্সেস করলে প্রয়োজনীয়। খোলা স্প্রেডশীটের সামগ্রীতে অস্থায়ী অ্যাক্সেস মঞ্জুর করে।
বর্তমান স্লাইড ফাইল অ্যাক্সেস	https://www.googleapis.com/auth/presentations.currentonly অ্যাড-অন অ্যাপস স্ক্রিপ্ট স্লাইড এপিআই অ্যাক্সেস করলে প্রয়োজনীয়। খোলা উপস্থাপনার বিষয়বস্তুতে অস্থায়ী অ্যাক্সেস মঞ্জুর করে।
প্রতি-ফাইল অ্যাক্সেস	https://www.googleapis.com/auth/drive.file onFileScopeGrantedTrigger ব্যবহার করার জন্য অ্যাড-অনের জন্য প্রয়োজন এবং যদি অ্যাড-অন ডক্স, শীট, স্লাইড বা ড্রাইভ API অ্যাক্সেস করে। অ্যাপস স্ক্রিপ্ট অ্যাডভান্সড ড্রাইভ পরিষেবা ব্যবহার করে অ্যাপ দ্বারা তৈরি বা খোলা ফাইলগুলিতে প্রতি-ফাইল অ্যাক্সেস মঞ্জুর করে৷ যদিও এটি মৌলিক ড্রাইভ পরিষেবা ব্যবহার করে অনুরূপ ক্রিয়াকলাপ ব্যবহারের অনুমতি দেয় না৷ ফাইল অনুমোদন প্রতি-ফাইলের ভিত্তিতে মঞ্জুর করা হয় এবং ব্যবহারকারী যখন অ্যাপটিকে অনুমোদন করে তখন প্রত্যাহার করা হয়।

জিমেইল

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

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

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

ব্যাপ্তি
নতুন খসড়া তৈরি করুন	https://www.googleapis.com/auth/gmail.addons.current.action.compose অ্যাড-অন কম্পোজ অ্যাকশন ট্রিগার ব্যবহার করলে প্রয়োজনীয়। অ্যাড-অনকে অস্থায়ীভাবে নতুন খসড়া বার্তা এবং উত্তর তৈরি করার অনুমতি দেয়। বিস্তারিত জানার জন্য খসড়া বার্তা রচনা দেখুন; এই সুযোগটি প্রায়শই রচনা ক্রিয়াগুলির সাথেও ব্যবহৃত হয়। একটি অ্যাক্সেস টোকেন প্রয়োজন.
ওপেন মেসেজ মেটাডেটা পড়ুন	https://www.googleapis.com/auth/gmail.addons.current.message.metadata খোলা বার্তার মেটাডেটা (যেমন বিষয় বা প্রাপকদের) অস্থায়ী অ্যাক্সেস মঞ্জুর করে। বার্তা সামগ্রী পড়ার অনুমতি দেয় না এবং একটি অ্যাক্সেস টোকেন প্রয়োজন। অ্যাড-অন কম্পোজ অ্যাকশন ট্রিগারে মেটাডেটা ব্যবহার করলে প্রয়োজনীয়। রচনা ক্রিয়াগুলির জন্য, যদি একটি রচনা ট্রিগারের মেটাডেটা অ্যাক্সেসের প্রয়োজন হয় তবে এই সুযোগটি প্রয়োজন৷ অনুশীলনে, এই সুযোগটি একটি উত্তর ইমেল খসড়ার প্রাপক তালিকা (:, cc:, এবং bcc:) কম্পোজ ট্রিগার অ্যাক্সেস করতে দেয়।
খোলা বার্তা বিষয়বস্তু পড়ুন	https://www.googleapis.com/auth/gmail.addons.current.message.action একটি ব্যবহারকারীর মিথস্ক্রিয়ায় খোলা বার্তার সামগ্রীতে অ্যাক্সেস মঞ্জুর করে, যেমন যখন একটি অ্যাড-অন মেনু আইটেম নির্বাচন করা হয়৷ একটি অ্যাক্সেস টোকেন প্রয়োজন.
খোলা থ্রেড বিষয়বস্তু পড়ুন	https://www.googleapis.com/auth/gmail.addons.current.message.readonly খোলা বার্তার মেটাডেটা এবং বিষয়বস্তুতে অস্থায়ী অ্যাক্সেস মঞ্জুর করে। এছাড়াও খোলা থ্রেডে অন্যান্য বার্তাগুলির বিষয়বস্তুতে অ্যাক্সেস মঞ্জুর করে৷ একটি অ্যাক্সেস টোকেন প্রয়োজন.
কোন বার্তা বিষয়বস্তু এবং মেটাডেটা পড়ুন	https://www.googleapis.com/auth/gmail.readonly খোলা বার্তা সহ যেকোনো ইমেল মেটাডেটা এবং বিষয়বস্তু পড়ুন। আপনার যদি অন্যান্য বার্তাগুলি সম্পর্কে তথ্য পড়তে হয়, যেমন একটি অনুসন্ধান ক্যোয়ারী পরিচালনা করার সময় বা একটি সম্পূর্ণ মেল থ্রেড পড়ার প্রয়োজন হয়। সতর্কতা : এটি একটি খুব বিস্তৃত, সীমাবদ্ধ সুযোগ । একেবারে প্রয়োজন হলেই এটি ব্যবহার করুন।

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

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

ব্যাপ্তি
ইভেন্ট মেটাডেটা অ্যাক্সেস করুন	https://www.googleapis.com/auth/calendar.addons.execute অ্যাড-অন ক্যালেন্ডার ইভেন্ট মেটাডেটা অ্যাক্সেস করলে প্রয়োজনীয়। অ্যাড-অনকে ইভেন্ট মেটাডেটা অ্যাক্সেস করার অনুমতি দেয়।
ব্যবহারকারীর তৈরি ইভেন্ট ডেটা পড়ুন	https://www.googleapis.com/auth/calendar.addons.current.event.read অ্যাড-অন ব্যবহারকারীর তৈরি ইভেন্ট ডেটা পড়তে হলে প্রয়োজন। অ্যাড-অনকে ব্যবহারকারীর তৈরি ইভেন্ট ডেটা অ্যাক্সেস করার অনুমতি দেয়। addOns.calendar.eventAccess ম্যানিফেস্ট ফিল্ডটি READ বা READ_WRITE এ সেট করা থাকলেই এই ডেটা পাওয়া যায়।
ব্যবহারকারীর দ্বারা তৈরি ইভেন্ট ডেটা লিখুন	https://www.googleapis.com/auth/calendar.addons.current.event.write অ্যাড-অন ব্যবহারকারীর তৈরি ইভেন্ট ডেটা লিখতে হলে প্রয়োজন। অ্যাড-অনকে ব্যবহারকারীর তৈরি ইভেন্ট ডেটা সম্পাদনা করার অনুমতি দেয়। addOns.calendar.eventAccess ম্যানিফেস্ট ফিল্ডটি WRITE বা READ_WRITE এ সেট করা থাকলেই এই ডেটা পাওয়া যায়।

Google চ্যাটের সুযোগ

ডেভেলপার প্রিভিউ: Google Workspace ডেভেলপার প্রিভিউ প্রোগ্রামের অংশ হিসেবে উপলভ্য, যা নির্দিষ্ট কিছু ফিচারে আগেভাগে অ্যাক্সেস দেয়।

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

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

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

পদ্ধতি	ব্যবহারকারীর প্রমাণীকরণ সমর্থিত	অ্যাপ প্রমাণীকরণ সমর্থিত	অনুমোদনের সুযোগ সমর্থিত
একটি বার্তা পাঠান			ব্যবহারকারীর প্রমাণীকরণ সহ: chat.messages.create chat.messages chat.import অ্যাপ প্রমাণীকরণ সহ: chat.bot
একটি স্থান তৈরি করুন			ব্যবহারকারীর প্রমাণীকরণ সহ: chat.spaces.create chat.spaces chat.import অ্যাপ প্রমাণীকরণ এবং প্রশাসকের অনুমোদন সহ ( ডেভেলপার পূর্বরূপ উপলব্ধ): chat.app.spaces.create chat.app.spaces
একটি স্থান তৈরি করুন এবং সদস্যদের যোগ করুন		-	ব্যবহারকারীর প্রমাণীকরণ সহ: chat.spaces.create chat.spaces
একটি স্পেসে একজন ব্যবহারকারী যোগ করুন			ব্যবহারকারীর প্রমাণীকরণ সহ: chat.memberships chat.memberships.app chat.import অ্যাপ প্রমাণীকরণ এবং প্রশাসকের অনুমোদন সহ ( ডেভেলপার পূর্বরূপ উপলব্ধ): chat.app.memberships
একটি চ্যাট স্পেস থেকে কার্যকলাপ বা ইভেন্ট তালিকা		-	ব্যবহারকারীর প্রমাণীকরণের সাথে, আপনাকে অনুরোধে অন্তর্ভুক্ত প্রতিটি ইভেন্ট প্রকারের জন্য একটি সুযোগ ব্যবহার করতে হবে: বার্তা সম্পর্কে ইভেন্টের জন্য: chat.messages chat.messages.readonly প্রতিক্রিয়া সম্পর্কে ইভেন্টগুলির জন্য: chat.messages.reactions chat.messages.reactions.readonly chat.messages chat.messages.readonly সদস্যতা সম্পর্কে ইভেন্টের জন্য: chat.memberships chat.memberships.readonly স্থান সম্পর্কে ইভেন্টের জন্য: chat.spaces chat.spaces.readonly

গুগল ড্রাইভের সুযোগ

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

ব্যাপ্তি
নির্বাচিত আইটেম মেটাডেটা পড়ুন	https://www.googleapis.com/auth/drive.addons.metadata.readonly ব্যবহারকারী যখন ড্রাইভে আইটেমগুলি নির্বাচন করেন তখন অ্যাড-অন একটি প্রাসঙ্গিক ইন্টারফেস ট্রিগার করা হলে তা প্রয়োজন৷ অ্যাড-অনকে Google ড্রাইভে ব্যবহারকারীর নির্বাচিত আইটেমগুলি সম্পর্কে সীমিত মেটাডেটা পড়ার অনুমতি দেয়৷ মেটাডেটা আইটেমের আইডি, শিরোনাম, MIME প্রকার, আইকন URL এবং অ্যাড-অনের আইটেম অ্যাক্সেস করার অনুমতি আছে কিনা তা সীমাবদ্ধ।
প্রতি-ফাইল অ্যাক্সেস	https://www.googleapis.com/auth/drive.file অ্যাড-অনের জন্য পৃথক ড্রাইভ ফাইলগুলি অ্যাক্সেস করার প্রয়োজন হলে প্রস্তাবিত৷ অ্যাপস স্ক্রিপ্ট অ্যাডভান্সড ড্রাইভ পরিষেবা ব্যবহার করে অ্যাপ দ্বারা তৈরি বা খোলা ফাইলগুলিতে প্রতি-ফাইল অ্যাক্সেস মঞ্জুর করে৷ যদিও এটি মৌলিক ড্রাইভ পরিষেবা ব্যবহার করে অনুরূপ ক্রিয়াকলাপ ব্যবহারের অনুমতি দেয় না৷ ফাইল অনুমোদন প্রতি-ফাইলের ভিত্তিতে মঞ্জুর করা হয় এবং ব্যবহারকারী যখন অ্যাপটিকে অনুমোদন করে তখন প্রত্যাহার করা হয়। নির্বাচিত ফাইলের উদাহরণের জন্য অনুরোধ ফাইল অ্যাক্সেস দেখুন।

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

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

দ্রষ্টব্য: Gmail স্কোপ সক্ষম করার চেয়ে অ্যাক্সেস টোকেন ScriptApp.getOAuthToken() দ্বারা ফেরত দেওয়া অ্যাক্সেস টোকেনের মতো নয় । আপনাকে অবশ্যই অ্যাকশন ইভেন্ট অবজেক্টে প্রদত্ত টোকেন ব্যবহার করতে হবে।

নিম্নলিখিতটি একটি বার্তার মেটাডেটা অ্যাক্সেসের অনুমতি দেওয়ার জন্য একটি অ্যাক্সেস টোকেন সেট করার একটি উদাহরণ দেখায়৷ এই উদাহরণের জন্য প্রয়োজনীয় একমাত্র সুযোগ হল 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 স্ক্রিপ্টকে এই স্কোপগুলি সনাক্ত করতে এবং স্বয়ংক্রিয়ভাবে ম্যানিফেস্ট আপডেট করতে দিতে পারেন৷ আপনার ম্যানিফেস্টের সুযোগের তালিকা সম্পাদনা করার সময়, কোনো সুযোগ সরাবেন না যদি না আপনি সেগুলিকে আরও উপযুক্ত বিকল্প দিয়ে প্রতিস্থাপন করেন, যেমন একটি সংকীর্ণ সুযোগ।

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

ব্যাপ্তি
ব্যবহারকারীর ইমেল ঠিকানা পড়ুন	https://www.googleapis.com/auth/userinfo.email প্রকল্পটিকে বর্তমান ব্যবহারকারীর ইমেল ঠিকানা পড়ার অনুমতি দেয়৷
বাহ্যিক পরিষেবাগুলিতে কল করার অনুমতি দিন	https://www.googleapis.com/auth/script.external_request প্রকল্পটিকে UrlFetch অনুরোধ করার অনুমতি দেয়৷ প্রকল্পটি অ্যাপস স্ক্রিপ্ট লাইব্রেরির জন্য OAuth2 ব্যবহার করলেও এটি প্রয়োজনীয়।
ব্যবহারকারীর লোকেল এবং টাইমজোন পড়ুন	https://www.googleapis.com/auth/script.locale বর্তমান ব্যবহারকারীর লোকেল এবং টাইমজোন শিখতে প্রকল্পটিকে অনুমতি দেয়৷ বিস্তারিত জানার জন্য ব্যবহারকারীর লোকেল এবং টাইমজোন অ্যাক্সেস করা দেখুন।
ট্রিগার তৈরি করুন	https://www.googleapis.com/auth/script.scriptapp প্রকল্পটিকে ট্রিগার তৈরি করার অনুমতি দেয়।
তৃতীয় পক্ষের লিঙ্কগুলির পূর্বরূপ দেখুন	https://www.googleapis.com/auth/workspace.linkpreview অ্যাড-অন প্রিভিউ যদি তৃতীয় পক্ষের পরিষেবা থেকে লিঙ্ক করে তাহলে প্রয়োজন। ব্যবহারকারী যখন এটির সাথে ইন্টারঅ্যাক্ট করছেন তখন প্রোজেক্টটিকে Google Workspace অ্যাপ্লিকেশনের মধ্যে একটি লিঙ্ক দেখতে দেয়। আরও জানতে, স্মার্ট চিপগুলির সাথে প্রিভিউ লিঙ্কগুলি দেখুন৷
তৃতীয় পক্ষের সম্পদ তৈরি করুন	https://www.googleapis.com/auth/workspace.linkcreate অ্যাড-অন যদি তৃতীয় পক্ষের পরিষেবাতে সংস্থান তৈরি করে তাহলে প্রয়োজনীয়৷ প্রজেক্টকে ব্যবহারকারীরা রিসোর্স তৈরির ফর্মে জমা দেওয়া তথ্য পড়তে এবং Google Workspace অ্যাপ্লিকেশনের মধ্যে রিসোর্সের একটি লিঙ্ক যোগ করার অনুমতি দেয়। আরও জানতে, @ মেনু থেকে তৃতীয় পক্ষের সংস্থান তৈরি করুন দেখুন।