জিমেইল এপিআই স্কোপ নির্বাচন করুন

এই ডকুমেন্টে Gmail API-নির্দিষ্ট অনুমোদন এবং প্রমাণীকরণের তথ্য রয়েছে। এই ডকুমেন্টটি পড়ার আগে, প্রমাণীকরণ এবং অনুমোদন সম্পর্কে জানুন -এ Google Workspace-এর সাধারণ প্রমাণীকরণ এবং অনুমোদনের তথ্য পড়তে ভুলবেন না।

অনুমোদনের জন্য OAuth 2.0 কনফিগার করুন

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

জিমেইল এপিআই স্কোপ

আপনার অ্যাপে প্রদত্ত অ্যাক্সেসের স্তর নির্ধারণ করতে, আপনাকে অনুমোদনের স্কোপগুলি সনাক্ত করতে হবে এবং ঘোষণা করতে হবে। অনুমোদনের স্কোপ হল একটি OAuth 2.0 URI স্ট্রিং যাতে Google Workspace অ্যাপের নাম, এটি কী ধরণের ডেটা অ্যাক্সেস করে এবং অ্যাক্সেসের স্তর থাকে। স্কোপ হল ব্যবহারকারীদের Google অ্যাকাউন্ট ডেটা সহ Google Workspace ডেটার সাথে কাজ করার জন্য আপনার অ্যাপের অনুরোধ।

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

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

অ-সংবেদনশীল স্কোপ

বেশিরভাগ ব্যবহারের ক্ষেত্রে নিম্নলিখিত Gmail API স্কোপগুলি সুপারিশ করা হয়:

স্কোপ কোড বিবরণ
https://www.googleapis.com/auth/gmail.addons.current.action.compose অ্যাড-অনের সাথে ইন্টারঅ্যাক্ট করার সময় ড্রাফ্ট পরিচালনা করুন এবং ইমেল পাঠান।
https://www.googleapis.com/auth/gmail.addons.current.message.action অ্যাড-অনের সাথে ইন্টারঅ্যাক্ট করার সময় আপনার ইমেল বার্তাগুলি দেখুন।
https://www.googleapis.com/auth/gmail.labels আপনার ইমেল লেবেলগুলি দেখুন এবং সম্পাদনা করুন।

সংবেদনশীল স্কোপ

স্কোপ কোড বিবরণ
https://www.googleapis.com/auth/gmail.addons.current.message.metadata অ্যাড-অনটি চলাকালীন আপনার ইমেল বার্তার মেটাডেটা দেখুন।
https://www.googleapis.com/auth/gmail.addons.current.message.readonly অ্যাড-অনটি চলাকালীন আপনার ইমেল বার্তাগুলি দেখুন।
https://www.googleapis.com/auth/gmail.send আপনার পক্ষ থেকে ইমেল পাঠান।

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

স্কোপ কোড বিবরণ
https://mail.google.com/ Gmail থেকে আপনার সমস্ত ইমেল পড়ুন, রচনা করুন, পাঠান এবং স্থায়ীভাবে মুছে ফেলুন।

দ্রষ্টব্য: যদি আপনার অ্যাপ্লিকেশনটির ট্র্যাশ বাইপাস করে অবিলম্বে এবং স্থায়ীভাবে থ্রেড এবং বার্তা মুছে ফেলার প্রয়োজন হয় তবেই এই স্কোপটির অনুরোধ করুন। আপনি কম অনুমতিমূলক স্কোপ ব্যবহার করে অন্যান্য সমস্ত কাজ সম্পাদন করতে পারেন।
https://www.googleapis.com/auth/gmail.readonly আপনার ইমেল বার্তা এবং সেটিংস দেখুন।
https://www.googleapis.com/auth/gmail.compose খসড়া পরিচালনা করুন এবং ইমেল পাঠান।
https://www.googleapis.com/auth/gmail.insert আপনার জিমেইল মেলবক্সে ইমেল যোগ করুন।
https://www.googleapis.com/auth/gmail.modify আপনার জিমেইল অ্যাকাউন্ট থেকে ইমেল পড়ুন, রচনা করুন এবং পাঠান। এই সুযোগটি ট্র্যাশ বাইপাস করে থ্রেড এবং বার্তাগুলি তাৎক্ষণিকভাবে, স্থায়ীভাবে মুছে ফেলার অনুমতি দেয় না।
https://www.googleapis.com/auth/gmail.metadata আপনার ইমেল বার্তার মেটাডেটা যেমন লেবেল এবং হেডার দেখুন, কিন্তু ইমেলের মূল অংশটি দেখুন না।
https://www.googleapis.com/auth/gmail.settings.basic Gmail-এ আপনার ইমেল সেটিংস এবং ফিল্টারগুলি দেখুন, সম্পাদনা করুন, তৈরি করুন বা পরিবর্তন করুন।
https://www.googleapis.com/auth/gmail.settings.sharing আপনার সংবেদনশীল মেল সেটিংস পরিচালনা করুন, যার মধ্যে কে আপনার মেল পরিচালনা করতে পারে তাও অন্তর্ভুক্ত।

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

পূর্ববর্তী সারণির স্কোপগুলি নিম্নলিখিত সংজ্ঞা অনুসারে তাদের সংবেদনশীলতা নির্দেশ করে:

ব্যবহারকারীর ডেটা অ্যাক্সেস করার অনুরোধ করার সময় Gmail API-এর ব্যবহার এবং অ্যাক্সেস নিয়ন্ত্রণকারী অতিরিক্ত তথ্য Google Workspace API ব্যবহারকারীর ডেটা এবং ডেভেলপার নীতিতে পাওয়া যাবে।

যদি আপনার অ্যাপের অন্য কোনও Google API-তে অ্যাক্সেসের প্রয়োজন হয়, তাহলে আপনি সেই স্কোপগুলিও যোগ করতে পারেন। Google API স্কোপ সম্পর্কে আরও তথ্যের জন্য, Google API-তে অ্যাক্সেস করার জন্য OAuth 2.0 ব্যবহার করা দেখুন।

নির্দিষ্ট OAuth 2.0 স্কোপ সম্পর্কে আরও তথ্যের জন্য, Google API-এর জন্য OAuth 2.0 স্কোপ দেখুন।

OAuth যাচাইকরণ

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