Gmail API

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

सेवा: gmail.googleapis.com

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

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

डिस्कवरी दस्तावेज़, मशीन से पढ़ा जा सकने वाला एक दस्तावेज़ होता है. इसमें REST API के बारे में जानकारी दी जाती है और उन्हें इस्तेमाल करने का तरीका बताया जाता है. इसका इस्तेमाल, 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}
किसी मौजूदा क्लाइंट-साइड एन्क्रिप्शन आइडेंटिटी के साथ, एक अलग कुंजी जोड़ता है.

REST रिसॉर्स: 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
चुनी गई थ्रेड को ट्रैश से हटाता है.