এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

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

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

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

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

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

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

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

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

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

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

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

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

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

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

আপনার অ্যাড-অন বর্তমানে কোন স্কোপগুলি ব্যবহার করে তা দেখুন । কোন পরিবর্তনগুলি করা প্রয়োজন তা নির্ধারণ করুন, যেমন একটি সংকীর্ণ স্কোপ ব্যবহার করা।
আপনার অ্যাড-অনের ম্যানিফেস্ট ফাইলটি খুলুন ।
oauthScopes লেবেলযুক্ত শীর্ষ-স্তরের ক্ষেত্রটি খুঁজুন। যদি এটি উপস্থিত না থাকে, তাহলে আপনি এটি যোগ করতে পারেন।
oauthScopes ফিল্ডটি স্ট্রিংগুলির একটি অ্যারে নির্দিষ্ট করে। আপনার প্রকল্পের ব্যবহৃত স্কোপগুলি সেট করতে, এই অ্যারের বিষয়বস্তুগুলিকে আপনি যে স্কোপগুলি ব্যবহার করতে চান তা দিয়ে প্রতিস্থাপন করুন। উদাহরণস্বরূপ, একটি Google Workspace অ্যাড-অনের জন্য যা Gmail প্রসারিত করে, আপনার নিম্নলিখিতগুলি থাকতে পারে:
```
{
  ...
  "oauthScopes": [
    "https://www.googleapis.com/auth/gmail.addons.current.message.metadata",
    "https://www.googleapis.com/auth/userinfo.email"
  ],
  ...
}
```
ম্যানিফেস্ট ফাইলের পরিবর্তনগুলি সংরক্ষণ করুন।

OAuth যাচাইকরণ

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

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

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

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

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

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

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

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

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

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

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

জিমেইল

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

নিচে Google Workspace অ্যাড-অনগুলির জন্য প্রায়শই ব্যবহৃত স্কোপগুলি দেওয়া হল যা Gmail প্রসারিত করে; যদি আপনার অ্যাড-অন Gmail প্রসারিত করে তবে Required লেবেলযুক্ত স্কোপগুলি আপনার 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` খোলা বার্তার মেটাডেটা (যেমন বিষয় বা প্রাপক) -এ অস্থায়ী অ্যাক্সেস দেয়। বার্তার বিষয়বস্তু পড়ার অনুমতি দেয় না এবং একটি অ্যাক্সেস টোকেন প্রয়োজন। যদি অ্যাড-অনটি কম্পোজ অ্যাকশন ট্রিগারে মেটাডেটা ব্যবহার করে তবে এটি প্রয়োজন। কম্পোজ অ্যাকশনের জন্য, যদি কোনও কম্পোজ ট্রিগারকে মেটাডেটা অ্যাক্সেসের প্রয়োজন হয় তবে এই স্কোপটি প্রয়োজন। বাস্তবে, এই স্কোপটি একটি কম্পোজ ট্রিগারকে একটি উত্তর ইমেল ড্রাফ্টের প্রাপক তালিকা (to:, 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` এ সেট করা থাকে।

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

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

চ্যাট স্কোপ এবং প্রমাণীকরণের ধরণ সম্পর্কে আরও জানতে, চ্যাট 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 Drive প্রসারিত করে।

ব্যাপ্তি

নির্বাচিত আইটেমের মেটাডেটা পড়ুন

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

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) ফাংশনটি কল করতে হবে। আপনাকে একটি অ্যাকশন ইভেন্ট অবজেক্ট থেকে একটি অ্যাক্সেস টোকেন পেতে হবে।

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

ব্যাপ্তি
ব্যবহারকারীর ইমেল ঠিকানা পড়ুন	`https://www.googleapis.com/auth/userinfo.email` প্রকল্পটিকে বর্তমান ব্যবহারকারীর ইমেল ঠিকানা পড়ার অনুমতি দেয়।
বহিরাগত পরিষেবাগুলিতে কল করার অনুমতি দিন	`https://www.googleapis.com/auth/script.external_request` প্রকল্পটিকে `UrlFetch` অনুরোধ করার অনুমতি দেয়। প্রকল্পটি যদি OAuth2 for Apps Script লাইব্রেরি ব্যবহার করে তবে এটিও প্রয়োজন।
ব্যবহারকারীর লোকেল এবং টাইমজোন পড়ুন	`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 অ্যাপ্লিকেশনের মধ্যে রিসোর্সের একটি লিঙ্ক সন্নিবেশ করতে দেয়। আরও জানতে, @ মেনু থেকে তৃতীয়-পক্ষের রিসোর্স তৈরি করুন দেখুন।