इस दस्तावेज़ में, ईमेल सेटिंग एपीआई और Gmail API के बीच के मुख्य अंतर के बारे में बताया गया है. अपने ऐप्लिकेशन को Gmail API पर माइग्रेट करने के लिए, इस गाइड का इस्तेमाल किया जा सकता है.
अनुरोधों को अनुमति देना
ईमेल सेटिंग एपीआई की तरह ही, Gmail API भी अनुरोधों को अनुमति देने के लिए, 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 का इस्तेमाल करता है. ज़्यादातर सेटिंग में की/वैल्यू पेयर होते हैं. इसलिए, वर्शन के बीच पेलोड एक जैसे होते हैं.
लेबल बनाने का उदाहरण:
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 में लेबल मैनेज करने के लिए, लेबल संसाधन का इस्तेमाल करें.
| पुरानी सेटिंग | नई सेटिंग | नोट |
|---|---|---|
| labelId | आईडी | |
| लेबल | नाम | |
| 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 में ईमेल अपने-आप फ़ॉरवर्ड होने की सुविधा को मैनेज करने के लिए, सेटिंग संसाधन का इस्तेमाल करें.
| पुरानी सेटिंग | नई सेटिंग | नोट |
|---|---|---|
| चालू करें | चालू किया गया | |
| forwardTo | emailAddress | |
| ऐक्शन गेम | disposition | KEEP अब leaveInInbox हैARCHIVE अब archive हैDELETE अब trash हैMARK_READ अब markRead है |
अन्य बदलाव:
- फ़ॉरवर्ड करने के लिए पते बनाने और उनकी पुष्टि करने के बाद ही उन्हें इस्तेमाल किया जा सकता है
- ईमेल फ़ॉरवर्ड करने के पतों को ForwardingAddresses रिसोर्स की मदद से मैनेज किया जा सकता है.
POP सेटिंग मैनेज करना
Gmail API में पीओपी ऐक्सेस मैनेज करने के लिए, सेटिंग संसाधन का इस्तेमाल करें.
| पुरानी सेटिंग | नई सेटिंग | नोट |
|---|---|---|
| चालू करें | accessWindow | disabled पर सेट होने पर बंद रहता है |
| enableFor | accessWindow | ALL_MAIL अब allMail हैMAIL_FROM_NOW_ON अब fromNowOn है |
| ऐक्शन गेम | disposition | KEEP अब leaveInInbox हैARCHIVE अब archive हैDELETE अब trash हैMARK_READ अब markRead है |
आईएमएपी सेटिंग मैनेज करना
Gmail API में आईएमएपी ऐक्सेस को मैनेज करने के लिए, सेटिंग संसाधन का इस्तेमाल करें.
| पुरानी सेटिंग | नई सेटिंग |
|---|---|
| चालू करें | चालू किया गया |
छुट्टी के दौरान अपने-आप जवाब देने की सुविधा की सेटिंग मैनेज करना
Gmail API में, छुट्टियों के दौरान अपने-आप जवाब देने की सुविधा को मैनेज करने के लिए, सेटिंग संसाधन का इस्तेमाल करें.
| पुरानी सेटिंग | नई सेटिंग |
|---|---|
| contactsOnly | restrictToContacts |
| domainOnly | restrictToDomain |
| चालू करें | enableAutoReply |
| endDate | endTime |
| मैसेज | responseBodyHtml responseBodyPlainText |
| startDate | startTime |
| subject | responseSubject |
हस्ताक्षर की सेटिंग मैनेज करना
Gmail API में ईमेल हस्ताक्षर मैनेज करने के लिए, SendAs संसाधन का इस्तेमाल करें.
| पुरानी सेटिंग | नई सेटिंग |
|---|---|
| signature | signature |
अन्य बदलाव:
- हस्ताक्षर अब हर उपनाम के हिसाब से मैनेज किए जाते हैं.
भाषा की सेटिंग मैनेज करना
Gmail API में भाषा की सेटिंग मैनेज करने के लिए, सेटिंग संसाधन का इस्तेमाल करें.
| पुरानी सेटिंग | नई सेटिंग |
|---|---|
| भाषा | displayLanguage |
ज़्यादा जानकारी के लिए, कृपया भाषा की सेटिंग मैनेज करने की गाइड देखें.
ऐक्सेस देने की सेटिंग मैनेज करना
Gmail API में, ईमेल खाते का ऐक्सेस देने की सुविधा को मैनेज करने के लिए, ऐक्सेस देने वाले संसाधन का इस्तेमाल करें.
| पुरानी सेटिंग | नई सेटिंग |
|---|---|
| पता | delegateEmail |
| स्थिति | verificationStatus |
अन्य बदलाव:
- सामान्य जानकारी
- ऐक्सेस देने के किसी भी तरीके का इस्तेमाल करने के लिए, delegates.create के साथ-साथ, ऐक्सेस देने वाले उपयोगकर्ता के पास Gmail का ऐक्सेस होना ज़रूरी है. उदाहरण के लिए, इसका मतलब है किGoogle Workspaceमें, ऐक्सेस देने वाले उपयोगकर्ता को निलंबित नहीं किया जा सकता.
- ईमेल के उपनाम का इस्तेमाल, ईमेल पाने के किसी भी नए तरीके के लिए, ईमेल पाने वाले व्यक्ति के ईमेल पते के तौर पर नहीं किया जा सकता. जिस उपयोगकर्ता को ऐक्सेस देना है उसका प्राइमरी ईमेल पता डालना ज़रूरी है.
- delegates.create
- इस तरीके का इस्तेमाल, अब एक ही Google Workspace संगठन के कई डोमेन के लिए, डेलिगेट रिलेशनशिप बनाने के लिए किया जा सकता है.
- इस तरीके का इस्तेमाल अब उन उपयोगकर्ताओं के लिए किया जा सकता है जिन्हें अगली बार साइन इन करने पर पासवर्ड बदलना होगा.
- अगर यह तरीका कामयाब होता है, तो यह जवाब के मुख्य हिस्से में खाली जवाब के बजाय, Users.settings.delegates रिसॉर्स दिखाता है.
- अगर ऐक्सेस देने वाला या ऐक्सेस पाने वाला कोई भी उपयोगकर्ता बंद है (उदाहरण के लिए, Google Workspaceमें निलंबित है), तो यह तरीका काम नहीं करता. इसके बजाय, एचटीटीपी 500 गड़बड़ी के बजाय एचटीटीपी 4XX गड़बड़ी दिखती है.
- delegates.delete
- अब इस तरीके का इस्तेमाल,
acceptedयाexpiredके बजाय, किसी भी verificationStatus वाले प्रतिनिधियों को मिटाने के लिए किया जा सकता है.
- अब इस तरीके का इस्तेमाल,
- delegates.get
- यह एक नया तरीका है. ज़रूरत के हिसाब से, यह delegates.list के मुकाबले बेहतर हो सकता है.
सामान्य सेटिंग मैनेज करना
सामान्य सेटिंग अब एपीआई के ज़रिए उपलब्ध नहीं हैं.