Gmail API

Gmail API की मदद से, थ्रेड, मैसेज, और लेबल जैसे Gmail मेलबॉक्स का डेटा देखा और मैनेज किया जा सकता है.

सेवा: gmail.googleapis.com

इस सेवा को कॉल करने के लिए, हमारा सुझाव है कि आप Google की क्लाइंट लाइब्रेरी का इस्तेमाल करें. अगर इस सेवा को कॉल करने के लिए आपके ऐप्लिकेशन को आपकी खुद की लाइब्रेरी की ज़रूरत है, तो एपीआई अनुरोध करते समय यहां दी गई जानकारी का इस्तेमाल करें.

डिस्कवरी दस्तावेज़

डिस्कवरी दस्तावेज़ एक ऐसी खास जानकारी है जिसे मशीन आसानी से पढ़ सकती है. इससे REST API के बारे में जानकारी मिलती है और उसका इस्तेमाल किया जाता है. इसका इस्तेमाल क्लाइंट लाइब्रेरी, IDE प्लगिन, और Google API के साथ इंटरैक्ट करने वाले अन्य टूल बनाने के लिए किया जाता है. एक सेवा में, आपकी खोज से जुड़े कई दस्तावेज़ मिल सकते हैं. यह सेवा, खोज के लिए ये दस्तावेज़ उपलब्ध कराती है:

सर्विस एंडपॉइंट

सेवा एंडपॉइंट एक बेस यूआरएल होता है, जो किसी एपीआई सेवा के नेटवर्क पते के बारे में बताता है. एक सेवा में एक से ज़्यादा सेवा एंडपॉइंट हो सकते हैं. इस सेवा में नीचे दिया गया सर्विस एंडपॉइंट है और नीचे दिए गए सभी यूआरआई, इस सर्विस एंडपॉइंट से जुड़े हैं:

  • https://gmail.googleapis.com

REST रिसॉर्स: v1.users

तरीके
getProfile GET /gmail/v1/users/{userId}/profile
इससे मौजूदा उपयोगकर्ता की Gmail प्रोफ़ाइल की जानकारी मिलती है.
stop POST /gmail/v1/users/{userId}/stop
उपयोगकर्ता के दिए गए मेलबॉक्स के लिए पुश नोटिफ़िकेशन पाना बंद करें.
watch POST /gmail/v1/users/{userId}/watch
उपयोगकर्ता के दिए गए मेलबॉक्स पर, पुश नोटिफ़िकेशन स्मार्टवॉच सेट अप या अपडेट करें.

REST रिसॉर्स: v1.users.drafts

तरीके
create POST /gmail/v1/users/{userId}/drafts
POST /upload/gmail/v1/users/{userId}/drafts
DRAFT लेबल वाला नया ड्राफ़्ट बनाता है.
delete DELETE /gmail/v1/users/{userId}/drafts/{id}
चुने गए ड्राफ़्ट को तुरंत और हमेशा के लिए मिटा देता है.
get GET /gmail/v1/users/{userId}/drafts/{id}
इससे तय किया गया ड्राफ़्ट मिलता है.
list GET /gmail/v1/users/{userId}/drafts
ड्राफ़्ट, उपयोगकर्ता के मेलबॉक्स में मौजूद होता है.
send POST /gmail/v1/users/{userId}/drafts/send
POST /upload/gmail/v1/users/{userId}/drafts/send
To, Cc, और Bcc हेडर में दिए गए मौजूदा ड्राफ़्ट को पाने वालों को भेजता है.
update PUT /gmail/v1/users/{userId}/drafts/{id}
PUT /upload/gmail/v1/users/{userId}/drafts/{id}
ड्राफ़्ट का कॉन्टेंट बदलता है.

REST रिसॉर्स: v1.users.history

तरीके
list GET /gmail/v1/users/{userId}/history
इसमें दिए गए मेलबॉक्स में किए गए सभी बदलावों का इतिहास मौजूद होता है.

REST रिसॉर्स: v1.users.labels

तरीके
create POST /gmail/v1/users/{userId}/labels
नया लेबल बनाता है.
delete DELETE /gmail/v1/users/{userId}/labels/{id}
डाले गए लेबल को तुरंत और हमेशा के लिए मिटा देता है. साथ ही, इसे ऐसे सभी मैसेज और थ्रेड से हटा देता है जिन पर यह लागू होता है.
get GET /gmail/v1/users/{userId}/labels/{id}
इससे तय किए गए लेबल मिलते हैं.
list GET /gmail/v1/users/{userId}/labels
इसमें उपयोगकर्ता के मेलबॉक्स में मौजूद सभी लेबल की सूची होती है.
patch PATCH /gmail/v1/users/{userId}/labels/{id}
तय किए गए लेबल को पैच करें.
update PUT /gmail/v1/users/{userId}/labels/{id}
तय किए गए लेबल को अपडेट करता है.

REST रिसॉर्स: v1.users.messages

तरीके
batchDelete POST /gmail/v1/users/{userId}/messages/batchDelete
मैसेज आईडी के हिसाब से कई मैसेज मिटाता है.
batchModify POST /gmail/v1/users/{userId}/messages/batchModify
तय किए गए मैसेज पर लेबल में बदलाव करता है.
delete DELETE /gmail/v1/users/{userId}/messages/{id}
चुना गया मैसेज तुरंत और हमेशा के लिए मिटा देता है.
get GET /gmail/v1/users/{userId}/messages/{id}
यहां बताया गया मैसेज मिलता है.
import POST /gmail/v1/users/{userId}/messages/import
POST /upload/gmail/v1/users/{userId}/messages/import
एक मैसेज को सिर्फ़ इस उपयोगकर्ता के मेलबॉक्स में इंपोर्ट करता है. इसमें ईमेल डिलीवरी को स्कैन और एसएमटीपी के ज़रिए पाने की तरह ही स्टैंडर्ड तरीका अपनाया जाता है.
insert POST /gmail/v1/users/{userId}/messages
POST /upload/gmail/v1/users/{userId}/messages
ज़्यादातर स्कैनिंग और कैटगरी को बायपास करते हुए, सीधे इस उपयोगकर्ता के सिर्फ़ IMAP APPEND जैसे मेलबॉक्स में एक मैसेज डाला जाता है.
list GET /gmail/v1/users/{userId}/messages
उपयोगकर्ता के मेलबॉक्स में मैसेज की सूची बनाता है.
modify POST /gmail/v1/users/{userId}/messages/{id}/modify
तय किए गए मैसेज पर लेबल में बदलाव करता है.
send POST /gmail/v1/users/{userId}/messages/send
POST /upload/gmail/v1/users/{userId}/messages/send
To, Cc, और Bcc हेडर में मौजूद पाने वालों को तय किया गया मैसेज भेजता है.
trash POST /gmail/v1/users/{userId}/messages/{id}/trash
बताए गए मैसेज को ट्रैश में ले जाता है.
untrash POST /gmail/v1/users/{userId}/messages/{id}/untrash
तय किए गए मैसेज को ट्रैश से हटाता है.

REST रिसॉर्स: v1.users.messages.attachments

तरीके
get GET /gmail/v1/users/{userId}/messages/{messageId}/attachments/{id}
इस मैसेज को अटैचमेंट के तौर पर मिलता है.

REST रिसॉर्स: v1.users.settings

तरीके
getAutoForwarding GET /gmail/v1/users/{userId}/settings/autoForwarding
इससे किसी खास खाते के लिए, अपने-आप फ़ॉरवर्ड होने की सेटिंग मिलती है.
getImap GET /gmail/v1/users/{userId}/settings/imap
को आईएमएपी सेटिंग मिलती हैं.
getLanguage GET /gmail/v1/users/{userId}/settings/language
भाषा की सेटिंग उपलब्ध होती है.
getPop GET /gmail/v1/users/{userId}/settings/pop
पीओपी सेटिंग पर सेट किया जाता है.
getVacation GET /gmail/v1/users/{userId}/settings/vacation
इससे, छुट्टी के दौरान ऑटोमैटिक रिप्लाई से जुड़ी सेटिंग की जानकारी मिलती है.
updateAutoForwarding PUT /gmail/v1/users/{userId}/settings/autoForwarding
इससे किसी खाते के लिए, अपने-आप फ़ॉरवर्ड होने की सेटिंग अपडेट हो जाती है.
updateImap PUT /gmail/v1/users/{userId}/settings/imap
आईएमएपी सेटिंग अपडेट करता है.
updateLanguage PUT /gmail/v1/users/{userId}/settings/language
भाषा की सेटिंग अपडेट करती है.
updatePop PUT /gmail/v1/users/{userId}/settings/pop
पीओपी सेटिंग को अपडेट करता है.
updateVacation PUT /gmail/v1/users/{userId}/settings/vacation
छुट्टी के दौरान ऑटोमैटिक रिप्लाई से जुड़ी सेटिंग अपडेट करती है.

REST रिसॉर्स: v1.users.settings.cse.identities

तरीके
create POST /gmail/v1/users/{userId}/settings/cse/identities
यह क्लाइंट-साइड एन्क्रिप्शन आइडेंटिटी बनाता है और कॉन्फ़िगर करता है. इससे उपयोगकर्ता खाते से मेल भेजने की अनुमति मिलती है.
delete DELETE /gmail/v1/users/{userId}/settings/cse/identities/{cseEmailAddress}
यह क्लाइंट-साइड एन्क्रिप्शन आइडेंटिटी को मिटा देता है.
get GET /gmail/v1/users/{userId}/settings/cse/identities/{cseEmailAddress}
यह क्लाइंट-साइड एन्क्रिप्शन आइडेंटिटी कॉन्फ़िगरेशन वापस लाता है.
list GET /gmail/v1/users/{userId}/settings/cse/identities
इसमें ऐसे उपयोगकर्ता की पहचान की जानकारी मौजूद होती है जिसकी पुष्टि हो चुकी है. यह जानकारी, क्लाइंट-साइड एन्क्रिप्शन की मदद से एन्क्रिप्ट की गई होती है.
patch PATCH /gmail/v1/users/{userId}/settings/cse/identities/{emailAddress}
यह सुविधा, क्लाइंट-साइड एन्क्रिप्शन की किसी मौजूदा आइडेंटिटी के साथ कुंजी के दूसरे जोड़े को जोड़ती है.

आराम करने के लिए संसाधन: v1.users.settings.cse.keypairs

तरीके
create POST /gmail/v1/users/{userId}/settings/cse/keypairs
पुष्टि किए गए उपयोगकर्ता के लिए, क्लाइंट-साइड एन्क्रिप्शन S/MIME सार्वजनिक कुंजी सर्टिफ़िकेट चेन और निजी कुंजी मेटाडेटा बनाता और अपलोड करता है.
disable POST /gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:disable
इससे क्लाइंट-साइड एन्क्रिप्शन की कुंजी का जोड़ा बंद हो जाता है.
enable POST /gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:enable
इससे क्लाइंट-साइड एन्क्रिप्शन की वह कुंजी चालू हो जाती है जो बंद हो गई थी.
get GET /gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}
इससे क्लाइंट-साइड एन्क्रिप्शन की मौजूदा कुंजी वापस मिलती है.
list GET /gmail/v1/users/{userId}/settings/cse/keypairs
यह डायलॉग बॉक्स, पुष्टि किए गए उपयोगकर्ता के लिए क्लाइंट-साइड एन्क्रिप्शन की कुंजी के जोड़े की सूची बनाता है.
obliterate POST /gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:obliterate
यह क्लाइंट-साइड एन्क्रिप्शन की कुंजी के जोड़े को हमेशा के लिए और तुरंत मिटा देता है.

REST रिसॉर्स: v1.users.settings.delegates

तरीके
create POST /gmail/v1/users/{userId}/settings/delegates
ऐसे व्यक्ति को अपने ईमेल खाते का ऐक्सेस देता है जिसकी पुष्टि का स्टेटस सीधे तौर पर accepted पर सेट होता है. इसके लिए, पुष्टि करने के लिए कोई ईमेल नहीं भेजा जाता.
delete DELETE /gmail/v1/users/{userId}/settings/delegates/{delegateEmail}
तय किए गए ऐक्सेस को हटाता है (जिसकी पुष्टि का कोई स्टेटस हो सकता है). साथ ही, इसे इस्तेमाल करने के लिए की गई किसी भी पुष्टि को रद्द कर देता है.
get GET /gmail/v1/users/{userId}/settings/delegates/{delegateEmail}
तय किया गया प्रतिनिधि ऐक्सेस करता है.
list GET /gmail/v1/users/{userId}/settings/delegates
यह तय किया जाता है कि चुने गए खाते के लिए, किन लोगों को संपर्कों का ऐक्सेस दिया गया है.

REST रिसॉर्स: v1.users.settings.filters

तरीके
create POST /gmail/v1/users/{userId}/settings/filters
फ़िल्टर बनाता है.
delete DELETE /gmail/v1/users/{userId}/settings/filters/{id}
चुना गया फ़िल्टर तुरंत और हमेशा के लिए मिटा देता है.
get GET /gmail/v1/users/{userId}/settings/filters/{id}
फ़िल्टर लगाया जाता है.
list GET /gmail/v1/users/{userId}/settings/filters
इसमें Gmail उपयोगकर्ता के मैसेज फ़िल्टर की सूची होती है.

REST रिसॉर्स: v1.users.settings.forwardingAddresses

तरीके
create POST /gmail/v1/users/{userId}/settings/forwardingAddresses
एक फ़ॉरवर्ड करने का पता बनाता है.
delete DELETE /gmail/v1/users/{userId}/settings/forwardingAddresses/{forwardingEmail}
चुने गए फ़ॉरवर्ड करने के पते को मिटा देता है. साथ ही, ज़रूरत पड़ने पर पुष्टि को रद्द कर देता है.
get GET /gmail/v1/users/{userId}/settings/forwardingAddresses/{forwardingEmail}
इससे, फ़ॉरवर्ड करने के लिए तय किया गया पता मिलता है.
list GET /gmail/v1/users/{userId}/settings/forwardingAddresses
इसमें, दिए गए खाते के लिए फ़ॉरवर्ड किए जाने वाले पते की सूची होती है.

REST रिसॉर्स: v1.users.settings.sendAs

तरीके
create POST /gmail/v1/users/{userId}/settings/sendAs
पसंद के मुताबिक "भेजने वाला" उपनाम बनाता है.
delete DELETE /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
तय किए गए इस उपनाम से भेजें को मिटाता है.
get GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
इससे भेजे जाने वाले खास उपनाम मिलते हैं.
list GET /gmail/v1/users/{userId}/settings/sendAs
दिए गए खाते के लिए, इस रूप में भेजें उपनाम की सूची बनाता है.
patch PATCH /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
दिए गए 'इस रूप में भेजें' उपनाम को पैच करें.
update PUT /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
ईमेल भेजने का उपनाम अपडेट करता है.
verify POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/verify
दिए गए 'इस रूप में भेजें' उपनाम वाले पते पर पुष्टि करने के लिए ईमेल भेजता है.

REST रिसॉर्स: v1.users.settings.sendAs.smimeInfo

तरीके
delete DELETE /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}
दिए गए 'इस रूप में भेजें' उपनाम के लिए, तय किया गया S/MIME कॉन्फ़िगरेशन मिटा देता है.
get GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}
तय किए गए 'इस रूप में भेजें' उपनाम के लिए, तय किया गया S/MIME कॉन्फ़िगरेशन देता है.
insert POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo
दिए गए 'इस रूप में भेजें' उपनाम के लिए, दिया गया S/MIME कॉन्फ़िगरेशन डालें (अपलोड करें).
list GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo
दिए गए 'इस रूप में भेजें' उपनाम के लिए, S/MIME कॉन्फ़िगरेशन की सूची बनाता है.
setDefault POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}/setDefault
दिए गए 'इस रूप में भेजें' उपनाम के लिए, डिफ़ॉल्ट S/MIME कॉन्फ़िगरेशन सेट करता है.

REST रिसॉर्स: v1.users.threads

तरीके
delete DELETE /gmail/v1/users/{userId}/threads/{id}
बताई गई थ्रेड को तुरंत और हमेशा के लिए मिटा देता है.
get GET /gmail/v1/users/{userId}/threads/{id}
यहां बताया गया थ्रेड मिलता है.
list GET /gmail/v1/users/{userId}/threads
उपयोगकर्ता के मेलबॉक्स में थ्रेड की सूची बनाता है.
modify POST /gmail/v1/users/{userId}/threads/{id}/modify
थ्रेड पर लागू किए गए लेबल में बदलाव किया जाता है.
trash POST /gmail/v1/users/{userId}/threads/{id}/trash
बताए गए थ्रेड को ट्रैश में ले जाता है.
untrash POST /gmail/v1/users/{userId}/threads/{id}/untrash
बताए गए थ्रेड को ट्रैश से हटाता है.