इस दस्तावेज़ में ईमेल सेटिंग एपीआई और 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
प्रतिनिधियों के बजाय, किसी अन्य व्यक्ति को संपर्कों को मिटाने के लिए किया जा सकता है.
- इस तरीके का इस्तेमाल, अब उन लोगों को मिटाने के लिए किया जा सकता है जिनके साथ verificationStatus का पता चलता है. इसका इस्तेमाल सिर्फ़
- delegates.get
- यह एक नया तरीका है, जिसे ज़रूरत के हिसाब से delegates.list से ज़्यादा प्राथमिकता दी जा सकती है.
सामान्य सेटिंग मैनेज करना
सामान्य सेटिंग अब एपीआई के ज़रिए उपलब्ध नहीं हैं.