ईमेल सेटिंग एपीआई से माइग्रेट करना

इस दस्तावेज़ में ईमेल सेटिंग एपीआई और Gmail एपीआई के बीच के मुख्य अंतर बताए गए हैं. इस गाइड की मदद से, अपने ऐप्लिकेशन को Gmail API पर माइग्रेट करें.

अनुरोधों को अनुमति देना

ईमेल सेटिंग एपीआई की तरह, Gmail एपीआई भी अनुरोधों को अनुमति देने के लिए, OAuth 2.0 प्रोटोकॉल का इस्तेमाल करता है. एक मुख्य अंतर यह है कि Gmail API की अनुमतियां पूरे डोमेन के बजाय, किसी एक उपयोगकर्ता के लिए होती हैं. इसका मतलब है कि किसी डोमेन एडमिन खाते को अनुमति देने से, आपको डोमेन के दूसरे उपयोगकर्ताओं के लिए मेल माइग्रेट नहीं करने मिलते. इसके बजाय, आपको पूरे डोमेन के अधिकार वाले स्टैंडर्ड सेवा खातों का इस्तेमाल करना होगा. इन्हें Admin console में अनुमति वाली सूची में शामिल किया जाता है, ताकि पुष्टि करने वाला सही टोकन जनरेट किया जा सके.

ईमेल सेटिंग एपीआई ने इस दायरे का इस्तेमाल किया:

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

प्रोटोकॉल में बदलाव

ईमेल सेटिंग एपीआई एक्सएमएल पर आधारित GDATA प्रोटोकॉल का इस्तेमाल करता है. Gmail API, JSON का इस्तेमाल करता है. सेटिंग में ज़्यादातर की/वैल्यू पेयर होती हैं. इसलिए, वर्शन के बीच पेलोड सैद्धांतिक रूप से एक जैसे होते हैं.

लेबल बनाने का उदाहरण:

ईमेल सेटिंग एपीआई

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>

Gmail API

POST https://www.googleapis.com/gmail/v1/users/{username}/labels
{
   "name": "status updates"
}

प्रोटोकॉल को सीधे तौर पर लागू करने के बजाय, दी गई क्लाइंट लाइब्रेरी का इस्तेमाल करें.

लेबल प्रबंधित करना

Gmail API में लेबल मैनेज करने के लिए, लेबल संसाधन का इस्तेमाल करें.

पुरानी सेटिंग नई सेटिंग ज़रूरी जानकारी
labelId id
लेबल नाम
unreadCount messagesUnread
किसे दिखे labelListVisibility SHOW अब labelShow है
HIDE अब labelHide है

अन्य बदलाव:

  • लेबल अपडेट करते समय या उन्हें मिटाते समय Gmail API, लेबल के नाम के बजाय आईडी से रेफ़रंस लेता है.

फ़िल्टर मैनेज करना

Gmail API में फ़िल्टर मैनेज करने के लिए, फ़िल्टर संसाधन का इस्तेमाल करें.

पुरानी सेटिंग नई सेटिंग ज़रूरी जानकारी
इन्होंने भेजा है criteria.from
से criteria.to
subject criteria.subject
hasTheWord criteria.query
doesNotHaveTheWord criteria.negatedQuery
hasAttachment criteria.hasAttachment
shouldArchive action.removeLabelIds लेबल आईडी के तौर पर INBOX का इस्तेमाल करें
shouldMarkAsRead action.removeLabelIds लेबल आईडी के तौर पर UNREAD का इस्तेमाल करें
shouldStar action.addLabelIds लेबल आईडी के तौर पर STARRED का इस्तेमाल करें
लेबल action.addLabelIds जोड़ने के लिए लेबल के आईडी का इस्तेमाल करें
forwardTo action.forward
shouldTrash action.addLabelIds लेबल आईडी के तौर पर TRASH का इस्तेमाल करें
neverSpam action.removeLabelIds लेबल आईडी के तौर पर SPAM का इस्तेमाल करें

अन्य बदलाव:

  • अगर किसी उपयोगकर्ता लेबल को जोड़ना पहले से मौजूद नहीं है, तो उसे labels.create तरीके से साफ़ तौर पर बनाया जाना चाहिए.

'इस रूप में भेजें' उपनाम मैनेज करना

Gmail API में इस रूप में भेजें उपनाम को मैनेज करने के लिए, SendAs संसाधन का इस्तेमाल करें.

पुरानी सेटिंग नई सेटिंग
नाम displayName
पता sendAsEmail
replyTo replyToAddress
makeDefault isDefault

वेब क्लिप मैनेज करना

वेब क्लिप की सेटिंग अब एपीआई की मदद से उपलब्ध नहीं हैं.

अपने आप आगे बढ़ने की सेटिंग मैनेज करना

Gmail API में, अपने-आप फ़ॉरवर्ड होने की सुविधा को मैनेज करने के लिए, सेटिंग संसाधन का इस्तेमाल करें.

पुरानी सेटिंग नई सेटिंग ज़रूरी जानकारी
enable चालू किया गया
forwardTo emailAddress
किसी खास रूटीन से जुड़ी कार्रवाई स्वभाव KEEP अब leaveInInbox
ARCHIVE है archive
DELETE अब trash
MARK_READ हो गया है markRead

अन्य बदलाव:

  • फ़ॉरवर्ड करने के पते का इस्तेमाल करने से पहले, उन्हें बनाया जाना और उनकी पुष्टि करना ज़रूरी है
  • फ़ॉरवर्ड करने के पतों को ForwardingAddresses के संसाधन से मैनेज किया जा सकता है.

पीओपी सेटिंग मैनेज करना

Gmail एपीआई में पीओपी ऐक्सेस को मैनेज करने के लिए, सेटिंग संसाधन का इस्तेमाल करें.

पुरानी सेटिंग नई सेटिंग ज़रूरी जानकारी
enable accessWindow disabled पर सेट होने पर बंद है
enableFor accessWindow ALL_MAIL अब allMail है
MAIL_FROM_NOW_ON अब fromNowOn है
किसी खास रूटीन से जुड़ी कार्रवाई स्वभाव KEEP अब leaveInInbox
ARCHIVE है archive
DELETE अब trash
MARK_READ हो गया है markRead

आईएमएपी सेटिंग मैनेज करना

Gmail API में आईएमएपी का ऐक्सेस मैनेज करने के लिए, सेटिंग संसाधन का इस्तेमाल करें.

पुरानी सेटिंग नई सेटिंग
enable चालू किया गया

छुट्टी के दौरान ऑटोमैटिक रिप्लाई सेटिंग मैनेज करना

Gmail API में, छुट्टियों के दौरान अपने-आप मिलने वाले जवाब की सुविधा को मैनेज करने के लिए, सेटिंग संसाधन का इस्तेमाल करें.

पुरानी सेटिंग नई सेटिंग
contactsOnly restrictToContacts
domainOnly restrictToDomain
enable enableAutoReply
endDate endTime
ग्राहक का मैसेज जवाबबॉडीएचटीएमएल
responseBodyPlainText
startDate startTime
subject responseSubject

हस्ताक्षर सेटिंग मैनेज करना

Gmail API में ईमेल हस्ताक्षर मैनेज करने के लिए, SendAs संसाधन का इस्तेमाल करें.

पुरानी सेटिंग नई सेटिंग
signature signature

अन्य बदलाव:

  • हस्ताक्षर को अब हर उपनाम के हिसाब से मैनेज किया जाता है.

भाषा की सेटिंग मैनेज करना

Gmail API में भाषा की सेटिंग मैनेज करने के लिए, सेटिंग संसाधन का इस्तेमाल करें.

पुरानी सेटिंग नई सेटिंग
language displayLanguage

ज़्यादा जानकारी के लिए, कृपया भाषा की सेटिंग मैनेज करने के लिए गाइड देखें.

ऐक्सेस देने की सेटिंग मैनेज करना

Gmail API में डेलिगेशन मैनेज करने के लिए, डेलिगेट संसाधन का इस्तेमाल करें.

पुरानी सेटिंग नई सेटिंग
पता delegateEmail
status verificationStatus

अन्य बदलाव:

  • सामान्य
    • किसी भी डेलिगेशन के तरीके (इसमें delegates.create) का इस्तेमाल करने के लिए, Gmail के लिए डेलिगेटर उपयोगकर्ता का चालू होना ज़रूरी है. उदाहरण के लिए, इसका मतलब है कि ऐक्सेस देने वाले उपयोगकर्ता कोGoogle Workspaceमें निलंबित नहीं किया जा सकता.
    • किसी भी नए तरीके के लिए, ईमेल उपनाम का इस्तेमाल प्रतिनिधि ईमेल इनपुट के तौर पर नहीं किया जा सकता. जिस उपयोगकर्ता को आपके ईमेल खाते का ऐक्सेस दिया गया है उसे उसके मुख्य ईमेल पते से भेजा जाना चाहिए.
  • delegates.create
    • अब इस तरीके का इस्तेमाल, एक ही Google Workspace संगठन से जुड़े कई डोमेन के लिए, दूसरों को अपने संपर्कों का ऐक्सेस देने के लिए किया जा सकता है.
    • यह तरीका अब उन लोगों के लिए इस्तेमाल किया जा सकता है जिन्हें अगली बार साइन इन करने पर पासवर्ड बदलना पड़ता है.
    • अगर यह तरीका काम करता है, तो जवाब के खाली हिस्से के बजाय, रिस्पॉन्स के मुख्य हिस्से में Users.settings.delegates संसाधन दिखाता है.
    • अगर प्रतिनिधि या प्रतिनिधि में से किसी एक उपयोगकर्ता को बंद किया गया है (उदाहरण के लिए, Google Workspaceमें निलंबित), तो यह तरीका एचटीटीपी 500 गड़बड़ी के बजाय एचटीटीपी 4XX गड़बड़ी के साथ काम नहीं करता है.
  • delegates.delete
    • इस तरीके का इस्तेमाल, अब उन लोगों को मिटाने के लिए किया जा सकता है जिनके साथ verificationStatus का पता चलता है. इसका इस्तेमाल सिर्फ़ accepted या expired प्रतिनिधियों के बजाय, किसी अन्य व्यक्ति को संपर्कों को मिटाने के लिए किया जा सकता है.
  • delegates.get
    • यह एक नया तरीका है, जिसे ज़रूरत के हिसाब से delegates.list से ज़्यादा प्राथमिकता दी जा सकती है.

सामान्य सेटिंग मैनेज करना

सामान्य सेटिंग अब एपीआई के ज़रिए उपलब्ध नहीं हैं.