ইমেল সেটিংস API থেকে স্থানান্তর করা হচ্ছে

এই নথিটি ইমেল সেটিংস API এবং Gmail API-এর মধ্যে মূল পার্থক্যগুলিকে কভার করে৷ আপনি আপনার অ্যাপটিকে Gmail API এ স্থানান্তরিত করতে সাহায্য করতে এই নির্দেশিকাটি ব্যবহার করতে পারেন।

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

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

ইমেল সেটিংস API সুযোগ ব্যবহার করেছে:

https://apps-apis.google.com/a/feeds/emailsettings/2.0/

Gmail API-এর সমতুল্য স্কোপগুলি হল:

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-এ লেবেলগুলি পরিচালনা করতে, লেবেল সংস্থান ব্যবহার করুন৷

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

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

  • লেবেল আপডেট বা মুছে ফেলার সময়, Gmail API নামের পরিবর্তে ID দ্বারা লেবেল উল্লেখ করে।

ফিল্টার পরিচালনা

Gmail API-এ ফিল্টার পরিচালনা করতে, ফিল্টার সংস্থান ব্যবহার করুন।

পুরানো সেটিং নতুন সেটিং মন্তব্য
থেকে criteria.from
প্রতি criteria.to
বিষয় criteria.subject
আছে TheWord criteria.query
DotHaveTheWord নেই criteria.negatedQuery
সংযুক্তি আছে criteria.hasAttachment
আর্কাইভ করা উচিত action.removeLabelIds লেবেল আইডি হিসাবে INBOX ব্যবহার করুন
MarkAsRead করা উচিত action.removeLabelIds লেবেল আইডি হিসাবে UNREAD ব্যবহার করুন
উচিত স্টার action.addLabelIds লেবেল আইডি হিসাবে STARRED ব্যবহার করুন৷
লেবেল action.addLabelIds যোগ করতে লেবেলের আইডি ব্যবহার করুন
সামনে action.forward
ট্র্যাশ করা উচিত action.addLabelIds লেবেল আইডি হিসাবে TRASH ব্যবহার করুন৷
কখনই স্প্যাম না action.removeLabelIds লেবেল আইডি হিসাবে SPAM ব্যবহার করুন

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

  • যদি একটি ব্যবহারকারী লেবেল যোগ করা ইতিমধ্যে বিদ্যমান না থাকে, তাহলে এটি অবশ্যই labels.create পদ্ধতি ব্যবহার করে স্পষ্টভাবে তৈরি করা উচিত।

উপনাম হিসাবে পাঠান পরিচালনা করা

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

পুরানো সেটিং নতুন সেটিং
নাম প্রদর্শন নাম
ঠিকানা sendAsEmail
প্রতিউত্তর উত্তর দেওয়ার ঠিকানা
ডিফল্ট করা ডিফল্ট

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

ওয়েব ক্লিপ সেটিংস API এর মাধ্যমে আর উপলব্ধ নেই৷

স্বয়ংক্রিয়-ফরোয়ার্ডিং সেটিংস পরিচালনা করা

Gmail API-এ স্বয়ংক্রিয়-ফরোয়ার্ডিং পরিচালনা করতে, সেটিংস সংস্থান ব্যবহার করুন৷

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

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

  • ফরোয়ার্ডিং ঠিকানা তৈরি এবং ব্যবহার করার আগে যাচাই করা আবশ্যক
  • ফরোয়ার্ডিং ঠিকানাগুলি ForwardingAddresses রিসোর্সের মাধ্যমে পরিচালনা করা যেতে পারে।

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

Gmail API-এ POP অ্যাক্সেস পরিচালনা করতে, সেটিংস সংস্থান ব্যবহার করুন৷

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

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

Gmail API-এ IMAP অ্যাক্সেস পরিচালনা করতে, সেটিংস সংস্থান ব্যবহার করুন৷

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

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

Gmail API-এ ছুটির স্বতঃ-উত্তর পরিচালনা করতে, সেটিংস সংস্থান ব্যবহার করুন৷

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

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

Gmail API-এ ইমেল স্বাক্ষর পরিচালনা করতে, SendAs রিসোর্স ব্যবহার করুন।

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

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

  • স্বাক্ষর এখন উপনাম প্রতি পরিচালিত হয়.

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

Gmail API-এ ভাষা সেটিংস পরিচালনা করতে, সেটিংস সংস্থান ব্যবহার করুন৷

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

আরও তথ্যের জন্য অনুগ্রহ করে ম্যানেজিং ভাষা সেটিংস নির্দেশিকা পড়ুন।

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

জিমেইল এপিআইতে প্রতিনিধিত্ব পরিচালনা করতে, প্রতিনিধি সংস্থান ব্যবহার করুন।

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

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

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

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

সাধারণ সেটিংস API এর মাধ্যমে আর উপলব্ধ নেই৷