এই ডকুমেন্টে ইমেল সেটিংস API এবং Gmail API এর মধ্যে মূল পার্থক্যগুলি আলোচনা করা হয়েছে। আপনার অ্যাপটিকে Gmail API তে স্থানান্তর করতে আপনি এই নির্দেশিকাটি ব্যবহার করতে পারেন।
অনুরোধ অনুমোদন করা হচ্ছে
ইমেল সেটিংস API-এর মতো, Gmail API অনুরোধ অনুমোদনের জন্য OAuth 2.0 প্রোটোকল ব্যবহার করে। একটি মূল পার্থক্য হল যে Gmail API অনুমতিগুলি সম্পূর্ণ ডোমেনের পরিবর্তে একজন পৃথক ব্যবহারকারীর জন্য সীমাবদ্ধ। এর অর্থ হল একটি ডোমেন প্রশাসক অ্যাকাউন্ট অনুমোদন করলে আপনি ডোমেনের অন্যান্য ব্যবহারকারীদের জন্য মেল স্থানান্তর করতে পারবেন না। পরিবর্তে, উপযুক্ত প্রমাণীকরণ টোকেন তৈরি করতে আপনাকে অ্যাডমিন কনসোলে সাদা তালিকাভুক্ত ডোমেন-ওয়াইড কর্তৃপক্ষ সহ স্ট্যান্ডার্ড পরিষেবা অ্যাকাউন্টগুলি ব্যবহার করতে হবে।
ইমেল সেটিংস API স্কোপটি ব্যবহার করেছে:
https://apps-apis.google.com/a/feeds/emailsettings/2.0/
জিমেইল এপিআই-তে সমতুল্য স্কোপগুলি হল:
https://www.googleapis.com/auth/gmail.settings.basic
https://www.googleapis.com/auth/gmail.settings.sharing
প্রোটোকল পরিবর্তন
ইমেল সেটিংস API XML ভিত্তিক GDATA প্রোটোকল ব্যবহার করে। Gmail API JSON ব্যবহার করে। যেহেতু সেটিংস বেশিরভাগই কী/মান জোড়া দিয়ে তৈরি, তাই পেলোডগুলি বিভিন্ন সংস্করণের ধারণাগতভাবে একই রকম।
লেবেল তৈরির উদাহরণ:
ইমেল সেটিংস API
POST https://apps-apis.google.com/a/feeds/emailsettings/2.0/{domain name}/{username}/label
<?xml version="1.0" encoding="utf-8"?>
<atom:entry xmlns:atom="http://www.w3.org/2005/Atom" xmlns:apps="http://schemas.google.com/apps/2006">
<apps:property name="label" value="status updates" />
</atom:entry>
জিমেইল এপিআই
POST https://www.googleapis.com/gmail/v1/users/{username}/labels
{
"name": "status updates"
}
প্রোটোকল সরাসরি বাস্তবায়নের পরিবর্তে প্রদত্ত ক্লায়েন্ট লাইব্রেরিগুলি ব্যবহার করুন।
লেবেল পরিচালনা করা
Gmail API-তে লেবেল পরিচালনা করতে, লেবেল রিসোর্স ব্যবহার করুন।
| পুরাতন সেটিং | নতুন সেটিং | মন্তব্য |
|---|---|---|
| লেবেল আইডি | আইডি | |
| লেবেল | নাম | |
| অপঠিতগণনা | বার্তাঅপঠিত | |
| দৃশ্যমানতা | লেবেল তালিকা দৃশ্যমানতা | SHOW এখন labelShowHIDE এখন labelHide |
অন্যান্য পরিবর্তন:
- লেবেল আপডেট বা মুছে ফেলার সময়, Gmail API নামের পরিবর্তে ID দ্বারা লেবেলগুলিকে উল্লেখ করে।
ফিল্টার পরিচালনা করা
জিমেইল এপিআই-তে ফিল্টার পরিচালনা করতে, ফিল্টার রিসোর্স ব্যবহার করুন।
| পুরাতন সেটিং | নতুন সেটিং | মন্তব্য |
|---|---|---|
| থেকে | মানদণ্ড.থেকে | |
| থেকে | মানদণ্ড.প্রতি | |
| বিষয় | মানদণ্ড.বিষয় | |
| hasTheWord সম্পর্কে | মানদণ্ড.কোয়েরি | |
| শব্দ নেই | মানদণ্ড.নেগেটেডকোয়েরি | |
| সংযুক্তি আছে | মানদণ্ড.হাসসংযুক্তি | |
| shouldArchive সম্পর্কে | action.removeLabelIds সম্পর্কে | লেবেল আইডি হিসেবে INBOX ব্যবহার করুন |
| shouldMarkAsRead সম্পর্কে | action.removeLabelIds সম্পর্কে | লেবেল আইডি হিসেবে UNREAD ব্যবহার করুন |
| shouldStar সম্পর্কে | action.addLabelIds সম্পর্কে | লেবেল আইডি হিসেবে STARRED ব্যবহার করুন |
| লেবেল | action.addLabelIds সম্পর্কে | যোগ করতে লেবেলের আইডি ব্যবহার করুন |
| ফরোয়ার্ডটু | অ্যাকশন.ফরওয়ার্ড | |
| ট্র্যাশ করা উচিত | action.addLabelIds সম্পর্কে | লেবেল আইডি হিসেবে TRASH ব্যবহার করুন |
| নেভারস্প্যাম | action.removeLabelIds সম্পর্কে | লেবেল আইডি হিসেবে SPAM ব্যবহার করুন |
অন্যান্য পরিবর্তন:
- যদি ব্যবহারকারীর লেবেল যোগ করার পদ্ধতি ইতিমধ্যেই বিদ্যমান না থাকে, তাহলে এটি labels.create পদ্ধতি ব্যবহার করে স্পষ্টভাবে তৈরি করতে হবে।
সেন্ড-অ্যাজ উপনাম পরিচালনা করা
Gmail API-তে send-as উপনাম পরিচালনা করতে, SendAs রিসোর্স ব্যবহার করুন।
| পুরাতন সেটিং | নতুন সেটিং |
|---|---|
| নাম | প্রদর্শনের নাম |
| ঠিকানা | ইমেইল পাঠান |
| উত্তর দিন | ঠিকানার উত্তর দিন |
| ডিফল্ট করুন | ডিফল্ট |
ওয়েব ক্লিপ পরিচালনা করা
ওয়েব ক্লিপ সেটিংস আর API এর মাধ্যমে উপলব্ধ নেই।
অটো-ফরওয়ার্ডিং সেটিংস পরিচালনা করা
Gmail API-তে অটো-ফরওয়ার্ডিং পরিচালনা করতে, সেটিংস রিসোর্স ব্যবহার করুন।
| পুরাতন সেটিং | নতুন সেটিং | মন্তব্য |
|---|---|---|
| সক্রিয় করা | সক্রিয় | |
| ফরোয়ার্ডটু | ইমেল ঠিকানা | |
| কর্ম | স্বভাব | KEEP এখন leaveInInboxARCHIVE এখন archiveDELETE এখন trashMARK_READ এখন markRead |
অন্যান্য পরিবর্তন:
- ব্যবহারের আগে ফরোয়ার্ডিং ঠিকানা তৈরি এবং যাচাই করতে হবে
- ফরোয়ার্ডিং ঠিকানাগুলি ফরোয়ার্ডিংএড্রেস রিসোর্সের মাধ্যমে পরিচালনা করা যেতে পারে।
POP সেটিংস পরিচালনা করা
Gmail API-তে POP অ্যাক্সেস পরিচালনা করতে, সেটিংস রিসোর্স ব্যবহার করুন।
| পুরাতন সেটিং | নতুন সেটিং | মন্তব্য |
|---|---|---|
| সক্রিয় করা | অ্যাক্সেস উইন্ডো | disabled সেট করা হলে অক্ষম করা হয়েছে |
| সক্রিয় করুন | অ্যাক্সেস উইন্ডো | ALL_MAIL এখন allMailMAIL_FROM_NOW_ON এখন fromNowOn |
| কর্ম | স্বভাব | KEEP এখন leaveInInboxARCHIVE এখন archiveDELETE এখন trashMARK_READ এখন markRead |
IMAP সেটিংস পরিচালনা করা
Gmail API-তে IMAP অ্যাক্সেস পরিচালনা করতে, সেটিংস রিসোর্স ব্যবহার করুন।
| পুরাতন সেটিং | নতুন সেটিং |
|---|---|
| সক্রিয় করা | সক্রিয় |
ছুটির স্বয়ংক্রিয় উত্তর সেটিংস পরিচালনা করা
Gmail API-তে ছুটির স্বয়ংক্রিয় উত্তর পরিচালনা করতে, সেটিংস রিসোর্স ব্যবহার করুন।
| পুরাতন সেটিং | নতুন সেটিং |
|---|---|
| শুধুমাত্র যোগাযোগ | যোগাযোগ সীমাবদ্ধ করুন |
| ডোমেইন-কেবলমাত্র | ডোমেইন সীমাবদ্ধ করুন |
| সক্রিয় করা | স্বয়ংক্রিয় উত্তর সক্ষম করুন |
| শেষ তারিখ | শেষ সময় |
| বার্তা | রেসপন্সবডিএইচটিএমএল রেসপন্সবডিপ্লেনটেক্সট |
| শুরুর তারিখ | শুরুর সময় |
| বিষয় | প্রতিক্রিয়াবিষয় |
স্বাক্ষর সেটিংস পরিচালনা করা
Gmail API-তে ইমেল স্বাক্ষর পরিচালনা করতে, SendAs রিসোর্স ব্যবহার করুন।
| পুরাতন সেটিং | নতুন সেটিং |
|---|---|
| স্বাক্ষর | স্বাক্ষর |
অন্যান্য পরিবর্তন:
- স্বাক্ষর এখন উপনাম অনুসারে পরিচালিত হয়।
ভাষা সেটিংস পরিচালনা করা
Gmail API-তে ভাষা সেটিংস পরিচালনা করতে, সেটিংস রিসোর্স ব্যবহার করুন।
| পুরাতন সেটিং | নতুন সেটিং |
|---|---|
| ভাষা | displayLanguage সম্পর্কে |
আরও তথ্যের জন্য অনুগ্রহ করে ভাষা সেটিংস পরিচালনা নির্দেশিকাটি দেখুন।
প্রতিনিধিত্ব সেটিংস পরিচালনা করা
Gmail API-তে ডেলিগেট পরিচালনা করতে, ডেলিগেটস রিসোর্স ব্যবহার করুন।
| পুরাতন সেটিং | নতুন সেটিং |
|---|---|
| ঠিকানা | ইমেল অর্পণ করুন |
| অবস্থা | যাচাইকরণের অবস্থা |
অন্যান্য পরিবর্তন:
- সাধারণ
- যেকোনো ডেলিগেশন পদ্ধতি ( delegates.create সহ) ব্যবহার করার জন্য, ডেলিগেটর ব্যবহারকারীকে Gmail-এর জন্য সক্রিয় করতে হবে। এর অর্থ, উদাহরণস্বরূপ, ডেলিগেটর ব্যবহারকারীকে Google Workspace-এ সাসপেন্ড করা যাবে না।
- নতুন কোনও পদ্ধতির জন্য ডেলিগেট ইমেল ইনপুট হিসেবে কোনও ইমেল উপনাম ব্যবহার করা যাবে না। একজন ডেলিগেট ব্যবহারকারীকে অবশ্যই তার প্রাথমিক ইমেল ঠিকানা দিয়ে রেফার করতে হবে।
- প্রতিনিধি.তৈরি করুন
- এই পদ্ধতিটি এখন একই Google Workspace সংস্থার একাধিক ডোমেন জুড়ে প্রতিনিধি সম্পর্ক তৈরি করতে ব্যবহার করা যেতে পারে।
- এই পদ্ধতিটি এখন সেই ব্যবহারকারীদের জন্য ব্যবহার করা যেতে পারে যাদের পরবর্তী সাইন ইনের সময় পাসওয়ার্ড পরিবর্তন করতে হবে।
- যদি সফল হয়, তাহলে এই পদ্ধতিটি একটি খালি প্রতিক্রিয়া বডির পরিবর্তে প্রতিক্রিয়া বডিতে একটি Users.settings.delegates রিসোর্স ফেরত পাঠাবে।
- যদি ডেলিগেটর বা ডেলিগেট ব্যবহারকারীদের মধ্যে যেকোনও একটি অক্ষম থাকে (উদাহরণস্বরূপ, Google Workspace-এ সাসপেন্ড করা হয়েছে), তাহলে এই পদ্ধতিটি HTTP 500 ত্রুটির পরিবর্তে HTTP 4XX ত্রুটির সাথে ব্যর্থ হয়।
- প্রতিনিধি.মুছে ফেলুন
- এই পদ্ধতিটি এখন যেকোনো verificationStatus সহ ডেলিগেট মুছে ফেলার জন্য ব্যবহার করা যেতে পারে, শুধুমাত্র
acceptedবাexpiredডেলিগেটগুলির পরিবর্তে।
- এই পদ্ধতিটি এখন যেকোনো verificationStatus সহ ডেলিগেট মুছে ফেলার জন্য ব্যবহার করা যেতে পারে, শুধুমাত্র
- প্রতিনিধি.পান
- এটি একটি নতুন পদ্ধতি, যা প্রয়োজনের উপর নির্ভর করে delegates.list পদ্ধতির চেয়ে পছন্দনীয় হতে পারে।
সাধারণ সেটিংস পরিচালনা করা
API এর মাধ্যমে সাধারণ সেটিংস আর উপলব্ধ নেই।