এই নথিতে Gmail API-নির্দিষ্ট অনুমোদন এবং প্রমাণীকরণ তথ্য রয়েছে। এই ডকুমেন্টটি পড়ার আগে, প্রমাণীকরণ এবং অনুমোদন সম্পর্কে জানুন- এ Google Workspace-এর সাধারণ প্রমাণীকরণ এবং অনুমোদন সংক্রান্ত তথ্য পড়তে ভুলবেন না।
অনুমোদনের জন্য OAuth 2.0 কনফিগার করুন
OAuth সম্মতি স্ক্রীন কনফিগার করুন এবং ব্যবহারকারী এবং অ্যাপ পর্যালোচনাকারীদের কাছে কোন তথ্য প্রদর্শন করা হবে তা নির্ধারণ করার জন্য স্কোপ বেছে নিন এবং আপনার অ্যাপটি নিবন্ধন করুন যাতে আপনি এটি পরে প্রকাশ করতে পারেন।
Gmail API স্কোপ
আপনার অ্যাপে প্রদত্ত অ্যাক্সেসের স্তর নির্ধারণ করতে, আপনাকে অনুমোদনের সুযোগ সনাক্ত করতে এবং ঘোষণা করতে হবে। অনুমোদনের সুযোগ হল একটি 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.addons.current.message.metadata | অ্যাড-অন চলাকালীন আপনার ইমেল বার্তা মেটাডেটা দেখুন। | সংবেদনশীল |
https://www.googleapis.com/auth/gmail.addons.current.message.readonly | অ্যাড-অন চলাকালীন আপনার ইমেল বার্তাগুলি দেখুন৷ | সংবেদনশীল |
https://www.googleapis.com/auth/gmail.labels | শুধুমাত্র লেবেল তৈরি করুন, পড়ুন, আপডেট করুন এবং মুছুন। | অ-সংবেদনশীল |
https://www.googleapis.com/auth/gmail.send | শুধুমাত্র বার্তা পাঠান. মেলবক্সে কোনো বিশেষাধিকার পড়া বা সংশোধন করা যাবে না। | সংবেদনশীল |
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 | মৌলিক মেল সেটিংস পরিচালনা করুন। | সীমাবদ্ধ |
https://www.googleapis.com/auth/gmail.settings.sharing | ফরওয়ার্ড করার নিয়ম এবং উপনাম সহ সংবেদনশীল মেল সেটিংস পরিচালনা করুন। দ্রষ্টব্য: এই সুযোগ দ্বারা সুরক্ষিত অপারেশনগুলি শুধুমাত্র প্রশাসনিক ব্যবহারের জন্য সীমাবদ্ধ। সেগুলি শুধুমাত্র Google Workspace গ্রাহকদের জন্য উপলভ্য যারা ডোমেন-ওয়াইড ডেলিগেশন সহ একটি পরিষেবা অ্যাকাউন্ট ব্যবহার করে। | সীমাবদ্ধ |
https://mail.google.com/ | থ্রেড এবং বার্তা স্থায়ীভাবে মুছে ফেলা সহ অ্যাকাউন্টের মেইলবক্সে সম্পূর্ণ অ্যাক্সেস অন্য সব কর্ম কম অনুমতিমূলক সুযোগ সঙ্গে সঞ্চালিত করা যেতে পারে. | সীমাবদ্ধ |
উপরের সারণীতে ব্যবহার কলামটি নিম্নলিখিত সংজ্ঞা অনুসারে প্রতিটি সুযোগের সংবেদনশীলতা নির্দেশ করে:
অ-সংবেদনশীল ——এই সুযোগগুলি অনুমোদন অ্যাক্সেসের ক্ষুদ্রতম ক্ষেত্র প্রদান করে এবং শুধুমাত্র মৌলিক অ্যাপ যাচাইকরণের প্রয়োজন হয়। এই প্রয়োজনীয়তা সম্পর্কে তথ্যের জন্য, যাচাইকরণের জন্য প্রস্তুতির পদক্ষেপগুলি দেখুন।
সংবেদনশীল — এই স্কোপগুলি Google ব্যবহারকারীর ডেটা অ্যাক্সেস করার অনুমতি দেয় এবং একটি সংবেদনশীল সুযোগ যাচাইকরণ প্রক্রিয়ার প্রয়োজন হয়৷ এই প্রয়োজনীয়তা সম্পর্কে তথ্যের জন্য, Google API পরিষেবাগুলি দেখুন: ব্যবহারকারীর ডেটা নীতি ৷ এই সুযোগগুলির জন্য নিরাপত্তা মূল্যায়নের প্রয়োজন নেই।
সীমাবদ্ধ — এই সুযোগগুলি Google ব্যবহারকারীর ডেটাতে বিস্তৃত অ্যাক্সেস প্রদান করে এবং আপনাকে একটি সীমাবদ্ধ সুযোগ যাচাইকরণ প্রক্রিয়ার মধ্য দিয়ে যেতে হবে। এই প্রয়োজনীয়তা সম্পর্কে তথ্যের জন্য, Google API পরিষেবাগুলি দেখুন: ব্যবহারকারীর ডেটা নীতি এবং নির্দিষ্ট API স্কোপের জন্য অতিরিক্ত প্রয়োজনীয়তা । আপনি যদি সার্ভারে সীমাবদ্ধ স্কোপ ডেটা সঞ্চয় করেন (বা ট্রান্সমিট), তাহলে আপনাকে একটি নিরাপত্তা মূল্যায়নের মধ্য দিয়ে যেতে হবে।
আপনি যখন ব্যবহারকারীর ডেটা অ্যাক্সেস করার অনুরোধ করেন তখন Gmail API-এ আপনার ব্যবহার এবং অ্যাক্সেস নিয়ন্ত্রণ করে এমন অতিরিক্ত তথ্য Gmail API পরিষেবা ব্যবহারকারী ডেটা এবং বিকাশকারী নীতিতে পাওয়া যেতে পারে।
আপনার অ্যাপের যদি অন্য কোনো Google API-এ অ্যাক্সেসের প্রয়োজন হয়, তাহলে আপনি সেই সুযোগগুলিও যোগ করতে পারেন। Google API স্কোপ সম্পর্কে আরও তথ্যের জন্য, Google API অ্যাক্সেস করতে OAuth 2.0 ব্যবহার করা দেখুন।
OAuth যাচাইকরণ
কিছু সংবেদনশীল OAuth স্কোপ ব্যবহার করার জন্য আপনার অ্যাপটিকে Google-এর OAuth যাচাইকরণ প্রক্রিয়ার মধ্য দিয়ে যেতে হবে। আপনার অ্যাপ কখন যাচাইকরণের মধ্য দিয়ে যাবে এবং কি ধরনের যাচাইকরণ প্রয়োজন তা নির্ধারণ করতে OAuth যাচাইকরণের প্রায়শই জিজ্ঞাসিত প্রশ্ন পড়ুন। Google API পরিষেবাগুলিও দেখুন: ব্যবহারকারীর ডেটা নীতি ৷