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

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

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

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

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

স্কোপ দেখুন

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

1. স্ক্রিপ্ট প্রজেক্টটি খুলুন।
2. বাম দিকে, Overview ক্লিক করুন।
3. 'Project OAuth Scopes'-এর অধীনে স্কোপগুলো দেখুন।

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

সুস্পষ্ট পরিধি নির্ধারণ করুন

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

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

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

আপনার স্ক্রিপ্ট প্রজেক্টের ম্যানিফেস্ট ফাইল সম্পাদনা করে আপনি এর ব্যবহৃত স্কোপগুলো স্পষ্টভাবে সেট করতে পারেন। ম্যানিফেস্ট ফিল্ড ' 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 ক্লায়েন্ট যাচাইকরণের প্রয়োজন হতে পারে। আরও তথ্যের জন্য, নিম্নলিখিত নির্দেশিকাগুলি দেখুন:

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

সীমাবদ্ধ পরিধি

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

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

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

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

গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য পরিধি নির্বাচন করুন

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

সম্পাদকের পরিধি

গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির নিম্নলিখিত বহুল ব্যবহৃত স্কোপগুলি গুগল ডক্স, গুগল শিটস এবং গুগল স্লাইডস-এর কার্যকারিতা প্রসারিত করে।

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

পরিধি
বর্তমান ডক্স ফাইল অ্যাক্সেস	https://www.googleapis.com/auth/documents.currentonly অ্যাড-অনটি যদি গুগল অ্যাপস স্ক্রিপ্ট ডকস এপিআই (Google 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 ব্যবহার করার জন্য এবং যদি অ্যাড-অনটি Docs, Sheets, Slides, বা Drive API অ্যাক্সেস করে, তবে এটি প্রয়োজন । এটি Apps Script Advanced Google Drive Service ব্যবহার করে অ্যাপ দ্বারা তৈরি বা খোলা ফাইলগুলিতে ফাইল-ভিত্তিক অ্যাক্সেস প্রদান করে। এটি বেসিক ড্রাইভ পরিষেবা ব্যবহার করে অনুরূপ কার্যকলাপের অনুমতি দেয় না। ফাইল অনুমোদন ফাইল-ভিত্তিক প্রদান করা হয় এবং ব্যবহারকারী যখন অ্যাপটিকে অনুমোদনমুক্ত করেন তখন তা বাতিল হয়ে যায়।

জিমেইল

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

নিম্নলিখিত সারণীতে জিমেইলকে সম্প্রসারিত করে এমন গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির জন্য প্রায়শই ব্যবহৃত স্কোপগুলির তালিকা দেওয়া হয়েছে। যদি আপনার অ্যাড-অন জিমেইলকে সম্প্রসারিত করে, তবে আপনাকে অবশ্যই ‘Required’ লেবেলযুক্ত যেকোনো স্কোপ আপনার গুগল ওয়ার্কস্পেস অ্যাড-অন ম্যানিফেস্টে যোগ করতে হবে।

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

পরিধি
নতুন খসড়া তৈরি করুন	https://www.googleapis.com/auth/gmail.addons.current.action.compose অ্যাড-অনটি যদি কম্পোজ অ্যাকশন ট্রিগার ব্যবহার করে, তবে এটি আবশ্যক। এটি অ্যাড-অনটিকে সাময়িকভাবে নতুন ড্রাফট মেসেজ এবং রিপ্লাই তৈরি করার অনুমতি দেয়। বিস্তারিত জানতে ‘কম্পোজিং ড্রাফট মেসেজ’ দেখুন; এই স্কোপটি প্রায়শই [কম্পোজ অ্যাকশন] (/workspace/add-ons/gmail/extending-compose-ui)-এর সাথে ব্যবহৃত হয়। এর জন্য একটি অ্যাক্সেস টোকেন প্রয়োজন।
খোলা বার্তার মেটাডেটা পড়ুন	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 খোলা বার্তা সহ যেকোনো ইমেলের মেটাডেটা এবং বিষয়বস্তু পড়ুন। অন্যান্য বার্তা সম্পর্কে তথ্য পড়ার প্রয়োজন হলে এটি আবশ্যক, যেমন কোনো অনুসন্ধান করার সময় বা সম্পূর্ণ একটি মেইল ​​থ্রেড পড়ার সময়। সতর্কীকরণ : এর পরিধি অত্যন্ত ব্যাপক ও সীমাবদ্ধ। শুধুমাত্র একান্ত প্রয়োজন হলেই এটি ব্যবহার করুন।

গুগল ক্যালেন্ডারের পরিধি

নিম্নলিখিত সারণিতে গুগল ক্যালেন্ডারের কার্যকারিতা বর্ধনকারী গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির প্রায়শই ব্যবহৃত স্কোপগুলি তালিকাভুক্ত করা হয়েছে।

পরিধি
ইভেন্টের মেটাডেটা অ্যাক্সেস করুন	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 এ সেট করা থাকে।

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

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

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

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

পদ্ধতি	ব্যবহারকারী প্রমাণীকরণ সমর্থিত	অ্যাপ প্রমাণীকরণ সমর্থিত	সমর্থিত অনুমোদনের পরিধি
একটি বার্তা পাঠান			ব্যবহারকারী প্রমাণীকরণের সাথে : 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

গুগল ড্রাইভের পরিধি

নিম্নলিখিত সারণিতে গুগল ওয়ার্কস্পেস অ্যাড-অনগুলির প্রায়শই ব্যবহৃত স্কোপগুলি তালিকাভুক্ত করা হয়েছে, যেগুলি গুগল ড্রাইভের কার্যকারিতা প্রসারিত করে।

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

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

ব্যবহারকারীর ডেটা সুরক্ষিত রাখতে, গুগল ওয়ার্কস্পেস অ্যাড-অনগুলিতে ব্যবহৃত জিমেইল স্কোপগুলি ব্যবহারকারীর ডেটাতে অস্থায়ী অ্যাক্সেস প্রদান করে। অস্থায়ী অ্যাক্সেস সক্রিয় করতে, একটি অ্যাকশন ইভেন্ট অবজেক্ট থেকে অ্যাক্সেস টোকেন ব্যবহার করে GmailApp.setCurrentMessageAccessToken কল করুন।

যে অ্যাক্সেস টোকেনটি জিমেইল স্কোপ সক্রিয় করে, সেটি 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();
}

অন্যান্য গুগল ওয়ার্কস্পেস স্কোপ

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

নিচের সারণিতে সেই স্কোপগুলো দেখানো হয়েছে যা গুগল ওয়ার্কস্পেস অ্যাড-অনগুলো প্রায়শই ব্যবহার করে থাকে:

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