ইমেল সেটিংস এপিআই থেকে মাইগ্রেট করুন

এই ডকুমেন্টটি আপনার অ্যাপকে অপ্রচলিত ইমেল সেটিংস এপিআই (Email Settings API) থেকে জিমেইল এপিআই (Gmail API)-তে মাইগ্রেট করতে সাহায্য করতে পারে।

অনুরোধ অনুমোদন করুন

ইমেল সেটিংস এপিআই-এর মতোই, জিমেইল এপিআই অনুরোধ অনুমোদন করার জন্য OAuth 2.0 প্রোটোকল ব্যবহার করে। একটি প্রধান পার্থক্য হলো, জিমেইল এপিআই-এর অনুমতি পুরো ডোমেইনের পরিবর্তে একজন নির্দিষ্ট ব্যবহারকারীর জন্য সীমাবদ্ধ থাকে। এর মানে হলো, একটি ডোমেইন অ্যাডমিনিস্ট্রেটর অ্যাকাউন্ট অনুমোদন করলে আপনি ডোমেইনের অন্যান্য ব্যবহারকারীদের জন্য মেইল ​​মাইগ্রেট করতে পারবেন না। পরিবর্তে, উপযুক্ত অথেনটিকেশন টোকেন তৈরি করার জন্য আপনাকে অবশ্যই ডোমেইন-ব্যাপী কর্তৃত্বসম্পন্ন স্ট্যান্ডার্ড সার্ভিস অ্যাকাউন্ট ব্যবহার করতে হবে, যেগুলোকে গুগল অ্যাডমিন কনসোলের একটি অ্যালাওলিস্টে যুক্ত করা থাকে।

ইমেল সেটিংস এপিআই নিম্নলিখিত স্কোপ ব্যবহার করেছে:

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

প্রোটোকল পরিবর্তন

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

লেবেল তৈরির উদাহরণ:

ইমেল সেটিংস এপিআই 

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"
}

সরাসরি প্রোটোকল প্রয়োগ করার পরিবর্তে প্রদত্ত ক্লায়েন্ট লাইব্রেরিগুলো ব্যবহার করুন।

লেবেল পরিচালনা করুন

জিমেইল এপিআই-তে লেবেল পরিচালনা করতে, labels রিসোর্সটি ব্যবহার করুন।

পুরানো সেটিং নতুন সেটিং নোট
লেবেলআইডি আইডি
লেবেল নাম
অপঠিত সংখ্যা অপঠিত বার্তা
দৃশ্যমানতা লেবেলতালিকা দৃশ্যমানতা SHOW এখন labelShow
HIDE এখন labelHide

অন্যান্য পরিবর্তন:

  • লেবেল আপডেট বা ডিলিট করার সময়, Gmail API নামের পরিবর্তে ID দ্বারা লেবেলগুলোকে শনাক্ত করে।

ফিল্টারগুলি পরিচালনা করুন

জিমেইল এপিআই-তে ফিল্টার পরিচালনা করতে, settings.filters রিসোর্সটি ব্যবহার করুন।

পুরানো সেটিং নতুন সেটিং নোট
থেকে মানদণ্ড থেকে
থেকে মানদণ্ড.
বিষয় মানদণ্ড.বিষয়
hasTheWord মানদণ্ড.কোয়েরি
শব্দটি নেই criteria.negatedQuery
সংযুক্তি আছে criteria.hasAttachment
শুডআর্কাইভ action.removeLabelIds লেবেল আইডি হিসেবে INBOX ব্যবহার করুন
পঠিত হিসাবে চিহ্নিত করা উচিত action.removeLabelIds লেবেল আইডি হিসেবে UNREAD ব্যবহার করুন
শুডস্টার action.addLabelIds লেবেল আইডি হিসেবে STARRED ব্যবহার করুন
লেবেল action.addLabelIds যোগ করতে লেবেলের আইডি ব্যবহার করুন
এগিয়ে যান পদক্ষেপ। এগিয়ে যান
আবর্জনা ফেলা উচিত action.addLabelIds লেবেল আইডি হিসেবে TRASH ব্যবহার করুন
কখনো স্প্যাম নয় action.removeLabelIds লেবেল আইডি হিসেবে SPAM ব্যবহার করুন

অন্যান্য পরিবর্তন:

  • যদি কোনো ইউজার লেবেল আগে থেকে বিদ্যমান না থাকে, তবে labels.create মেথড ব্যবহার করে তা স্পষ্টভাবে তৈরি করতে হবে।

প্রেরণ-হিসাব উপনামগুলি পরিচালনা করুন

জিমেইল এপিআই-তে সেন্ড-অ্যাজ অ্যালিয়াস পরিচালনা করতে, settings.sendAs রিসোর্সটি ব্যবহার করুন।

পুরানো সেটিং নতুন সেটিং
নাম ডিসপ্লে নাম
ঠিকানা ইমেইল হিসেবে পাঠান
উত্তর দিন উত্তর দিন ঠিকানা
ডিফল্ট তৈরি করুন ডিফল্ট

ওয়েব ক্লিপ পরিচালনা করুন

জিমেইল এপিআই-তে ওয়েব ক্লিপ সেটিংস উপলব্ধ নেই।

স্বয়ংক্রিয় ফরওয়ার্ডিং পরিচালনা করুন

জিমেইল এপিআই-তে স্বয়ংক্রিয় ফরওয়ার্ডিং পরিচালনা করতে, settings রিসোর্সটি ব্যবহার করুন।

পুরানো সেটিং নতুন সেটিং নোট
সক্ষম করুন সক্ষম
এগিয়ে যান ইমেইল ঠিকানা
পদক্ষেপ স্বভাব KEEP এখন leaveInInbox
ARCHIVE এখন archive
DELETE এখন trash
MARK_READ এখন markRead

অন্যান্য পরিবর্তন:

  • ব্যবহারের পূর্বে ফরওয়ার্ডিং ঠিকানা তৈরি ও যাচাই করে নিতে হবে।
  • settings.forwardingAddresses রিসোর্সটি ব্যবহার করে ফরওয়ার্ডিং অ্যাড্রেসগুলো পরিচালনা করা যায়।

POP সেটিংস পরিচালনা করুন

Gmail API-তে POP অ্যাক্সেস পরিচালনা করতে, settings রিসোর্সটি ব্যবহার করুন।

পুরানো সেটিং নতুন সেটিং নোট
সক্ষম করুন অ্যাক্সেস উইন্ডো disabled করা হলে নিষ্ক্রিয় থাকে
সক্ষম করুন অ্যাক্সেস উইন্ডো ALL_MAIL এখন allMail
MAIL_FROM_NOW_ON এখন fromNowOn হবে
পদক্ষেপ স্বভাব KEEP এখন leaveInInbox
ARCHIVE এখন archive
DELETE এখন trash
MARK_READ এখন markRead

IMAP সেটিংস পরিচালনা করুন

জিমেইল এপিআই-তে আইম্যাপ (IMAP) অ্যাক্সেস পরিচালনা করতে, settings রিসোর্সটি ব্যবহার করুন।

পুরানো সেটিং নতুন সেটিং
সক্ষম করুন সক্ষম

ছুটির স্বয়ংক্রিয় উত্তর সেটিংস পরিচালনা করুন

জিমেইল এপিআই-তে অবকাশকালীন স্বয়ংক্রিয় উত্তর পরিচালনা করতে, settings রিসোর্সটি ব্যবহার করুন।

পুরানো সেটিং নতুন সেটিং
শুধুমাত্র যোগাযোগ পরিচিতি সীমাবদ্ধ করুন
ডোমেইনঅনলি সীমাবদ্ধ করুন
সক্ষম করুন স্বয়ংক্রিয় উত্তর সক্ষম করুন
শেষ তারিখ শেষ সময়
বার্তা প্রতিক্রিয়া বডি এইচটিএমএল
প্রতিক্রিয়া মূল লেখা
শুরুর তারিখ শুরুর সময়
বিষয় প্রতিক্রিয়া বিষয়

স্বাক্ষর সেটিংস পরিচালনা করুন

জিমেইল এপিআই-তে ইমেইল সিগনেচার পরিচালনা করতে, settings.sendAs রিসোর্সটি ব্যবহার করুন।

পুরানো সেটিং নতুন সেটিং
স্বাক্ষর স্বাক্ষর

অন্যান্য পরিবর্তন:

  • স্বাক্ষরগুলো এখন ছদ্মনাম অনুযায়ী পরিচালিত হয়।

ভাষা সেটিংস পরিচালনা করুন

জিমেইল এপিআই-তে ভাষার সেটিংস পরিচালনা করতে, settings রিসোর্সটি ব্যবহার করুন।

পুরানো সেটিং নতুন সেটিং
ভাষা প্রদর্শন ভাষা

আরও তথ্যের জন্য, ভাষা সেটিংস পরিচালনা দেখুন।

প্রতিনিধি সেটিংস পরিচালনা করুন

জিমেইল এপিআই-তে ডেলিগেশন পরিচালনা করতে, settings.delegates রিসোর্সটি ব্যবহার করুন।

পুরানো সেটিং নতুন সেটিং
ঠিকানা প্রতিনিধিইমেল
অবস্থা যাচাইকরণ স্থিতি

অন্যান্য পরিবর্তন:

  • সাধারণ
    • যেকোনো ডেলিগেশন পদ্ধতি ( settings.delegates.create সহ) ব্যবহার করতে হলে, ডেলিগেটর ব্যবহারকারীকে অবশ্যই Gmail-এর জন্য সক্রিয় থাকতে হবে। এর মানে হলো, উদাহরণস্বরূপ, ডেলিগেটর ব্যবহারকারীকে Google Workspace-এ সাসপেন্ড করা যাবে না।
    • নতুন পদ্ধতিগুলোর কোনোটির ক্ষেত্রেই ডেলিগেট ইমেল ইনপুট হিসেবে ইমেল অ্যালিয়াস ব্যবহার করা যাবে না। একজন ডেলিগেট ব্যবহারকারীকে অবশ্যই তার প্রাথমিক ইমেল ঠিকানা দ্বারা উল্লেখ করতে হবে।
  • settings.delegates.create
    • এই পদ্ধতিটি এখন একই গুগল ওয়ার্কস্পেস অর্গানাইজেশনের অন্তর্গত একাধিক ডোমেইনের মধ্যে ডেলিগেট সম্পর্ক তৈরি করতে ব্যবহার করা যাবে।
    • যেসব ব্যবহারকারীর পরবর্তী সাইন-ইনের সময় পাসওয়ার্ড পরিবর্তনের প্রয়োজন হয়, তারা এখন এই পদ্ধতিটি ব্যবহার করতে পারবেন।
    • সফল হলে, এই মেথডটি রেসপন্স বডিতে একটি খালি রেসপন্স বডির পরিবর্তে একটি settings.delegates রিসোর্স রিটার্ন করে।
    • যদি ডেলিগেটর বা ডেলিগেট ব্যবহারকারীদের মধ্যে কেউ নিষ্ক্রিয় থাকে (উদাহরণস্বরূপ, গুগল ওয়ার্কস্পেসে সাসপেন্ড করা হলে), তাহলে এই মেথডটি HTTP 500 এররের পরিবর্তে HTTP 4XX এরর দিয়ে ব্যর্থ হয়।
  • settings.delegates.delete
    • এই পদ্ধতিটি এখন শুধু accepted বা expired ডেলিগেটদেরই নয়, বরং যেকোনো VerificationStatus সহ ডেলিগেটদেরও মুছে ফেলার জন্য ব্যবহার করা যাবে।
  • settings.delegates.get
    • এটি একটি নতুন পদ্ধতি, যা প্রয়োজনের উপর নির্ভর করে settings.delegates.list পদ্ধতির চেয়ে বেশি সুবিধাজনক হতে পারে।

সাধারণ সেটিংস পরিচালনা করুন

জিমেইল এপিআই-তে সাধারণ সেটিংস উপলব্ধ নেই।