Email Settings API से माइग्रेट करना

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

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

Email Settings API की तरह, Gmail API भी अनुरोधों को अनुमति देने के लिए OAuth 2.0 प्रोटोकॉल का इस्तेमाल करता है. इन दोनों के बीच मुख्य अंतर यह है कि Gmail API की अनुमतियां, पूरे डोमेन के बजाय किसी एक उपयोगकर्ता के लिए तय की जाती हैं. इसका मतलब है कि डोमेन एडमिन खाते को अनुमति देने से, आपको डोमेन के अन्य उपयोगकर्ताओं के लिए ईमेल माइग्रेट करने की सुविधा नहीं मिलती. इसके बजाय, आपको डोमेन-वाइड अथॉरिटी वाले स्टैंडर्ड सेवा खातों का इस्तेमाल करना होगा. इन्हें Google 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

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

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

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

Email Settings 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>

Gmail API

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

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

लेबल मैनेज करें

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

पुरानी सेटिंग	नई सेटिंग	नोट
labelId	आईडी
लेबल	नाम
unreadCount	messagesUnread
कैसा दिखाई दे	labelListVisibility	SHOW की कीमत अब labelShow HIDE हो गई है. labelHide की कीमत अब हो गई है

अन्य बदलाव:

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

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

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

पुरानी सेटिंग	नई सेटिंग	नोट
से	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 में, 'इस पते से भेजें' सुविधा के लिए इस्तेमाल किए जाने वाले ईमेल पतों को मैनेज करने के लिए, settings.sendAs रिसॉर्स का इस्तेमाल करें.

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

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

Gmail API में, वेब क्लिप की सेटिंग उपलब्ध नहीं हैं.

मैसेज अपने-आप फ़ॉरवर्ड होने की सुविधा मैनेज करना

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

पुरानी सेटिंग	नई सेटिंग	नोट
चालू करें	चालू किया गया
forwardTo	emailAddress
ऐक्शन गेम	disposition	KEEP की कीमत अब leaveInInbox ARCHIVE की कीमत अब archive DELETE की कीमत अब trash MARK_READ की कीमत अब markRead हो गई है

अन्य बदलाव:

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

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

Gmail API में पीओपी ऐक्सेस को मैनेज करने के लिए, settings रिसॉर्स का इस्तेमाल करें.

पुरानी सेटिंग	नई सेटिंग	नोट
चालू करें	accessWindow	disabled पर सेट होने पर यह सुविधा बंद हो जाती है
enableFor	accessWindow	ALL_MAIL की कीमत अब allMail MAIL_FROM_NOW_ON हो गई है. fromNowOn की कीमत अब हो गई है
ऐक्शन गेम	disposition	KEEP की कीमत अब leaveInInbox ARCHIVE की कीमत अब archive DELETE की कीमत अब trash MARK_READ की कीमत अब markRead हो गई है

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

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

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

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

Gmail API में, छुट्टी के दौरान ऑटोमैटिक रिप्लाई की सुविधा को मैनेज करने के लिए, settings संसाधन का इस्तेमाल करें.

पुरानी सेटिंग	नई सेटिंग
contactsOnly	restrictToContacts
domainOnly	restrictToDomain
चालू करें	enableAutoReply
endDate	endTime
मैसेज	responseBodyHtml responseBodyPlainText
startDate	startTime
subject	responseSubject

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

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

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

अन्य बदलाव:

• अब हर उपनाम के लिए अलग-अलग हस्ताक्षर मैनेज किए जा सकते हैं.

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

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

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

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

प्रतिनिधि सेटिंग मैनेज करना

Gmail API में ईमेल भेजने का अधिकार मैनेज करने के लिए, settings.delegates रिसॉर्स का इस्तेमाल करें.

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

अन्य बदलाव:

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

सामान्य सेटिंग प्रबंधित करें

Gmail API में सामान्य सेटिंग उपलब्ध नहीं हैं.