इस दस्तावेज़ में Gmail API से जुड़ा खास अधिकार है और पुष्टि करने की जानकारी. इस दस्तावेज़ को पढ़ने से पहले, पक्का करें कि पुष्टि करने और अनुमति देने की सामान्य जानकारी पुष्टि करने और अनुमति देने के बारे में जानें.
अनुमति देने के लिए, OAuth 2.0 को कॉन्फ़िगर करें
उस स्क्रीन को कॉन्फ़िगर करना जहां OAuth के लिए सहमति दी जाती है और स्कोप चुनें ताकि यह तय किया जा सके कि उपयोगकर्ताओं और ऐप्लिकेशन की समीक्षा करने वाले लोगों को कौनसी जानकारी दिखाई जाए. ताकि आप इसे बाद में प्रकाशित कर सकें.
Gmail API के दायरे
आपके ऐप्लिकेशन को दिए गए ऐक्सेस का लेवल तय करने के लिए, आपको अनुमति के दायरे के बारे में बताएं. अनुमति का स्कोप, OAuth 2.0 यूआरआई स्ट्रिंग है जिसमें Google Workspace ऐप्लिकेशन का नाम, यह किस तरह का डेटा ऐक्सेस करता है, और ऐक्सेस का लेवल तय कर सकते हैं. ये दायरे, आपके ऐप्लिकेशन के Google Workspace डेटा के साथ काम करने के अनुरोधों का दायरा तय करते हैं. इनमें ये दायरे शामिल हैं उपयोगकर्ताओं का Google खाते में मौजूद डेटा.
आपका ऐप्लिकेशन इंस्टॉल होने पर, उपयोगकर्ता से उन दायरों की पुष्टि करने के लिए कहा जाता है ऐप से. आम तौर पर, आपको सबसे सटीक और सटीक स्कोप चुनना चाहिए और ऐसे दायरों का अनुरोध करने से बचें जिनकी ज़रूरत आपके ऐप्लिकेशन में नहीं है. ज़्यादा उपयोगकर्ता सीमित और साफ़ तौर पर बताए गए दायरों का ऐक्सेस आसानी से देना.
Gmail API इन दायरों के साथ काम करता है:
| दायरा कोड | ब्यौरा | इस्तेमाल |
|---|---|---|
https://www.googleapis.com/auth/gmail.addons.current.action.compose |
इससे इंटरैक्ट करते समय, ड्राफ़्ट मैनेज करने और ईमेल भेजने की सुविधा ऐड-ऑन. | संवेदनशील नहीं है |
https://www.googleapis.com/auth/gmail.addons.current.message.action |
इससे सहभागिता करते समय अपने ईमेल संदेश देखें ऐड-ऑन. | संवेदनशील नहीं है |
https://www.googleapis.com/auth/gmail.addons.current.message.metadata |
ऐड-ऑन के समय अपने ईमेल मैसेज का मेटाडेटा देखें चल रहा है. | संवेदनशील |
https://www.googleapis.com/auth/gmail.addons.current.message.readonly |
ऐड-ऑन होने पर अपने ईमेल देखें दौड़ने. | संवेदनशील |
https://www.googleapis.com/auth/gmail.labels |
सिर्फ़ लेबल बनाएं, पढ़ें, अपडेट करें, और मिटाएं. | संवेदनशील नहीं है |
https://www.googleapis.com/auth/gmail.send |
सिर्फ़ मैसेज भेजें. मेलबॉक्स पर खास अधिकारों को पढ़ा या बदला नहीं जा सकता. | संवेदनशील |
https://www.googleapis.com/auth/gmail.readonly |
सभी संसाधनों और उनके मेटाडेटा को पढ़ें—लिखने के लिए कोई कार्रवाई नहीं. | सभी देशों/इलाकों में उपलब्ध नहीं है |
https://www.googleapis.com/auth/gmail.compose |
ड्राफ़्ट बनाएं, पढ़ें, अपडेट करें, और मिटाएं. मैसेज और ड्राफ़्ट भेजना. | सभी देशों/इलाकों में उपलब्ध नहीं है |
https://www.googleapis.com/auth/gmail.insert |
सिर्फ़ मैसेज डालें और इंपोर्ट करें. | सभी देशों/इलाकों में उपलब्ध नहीं है |
https://www.googleapis.com/auth/gmail.modify |
के तुरंत, स्थायी हटाए जाने को छोड़कर सभी रीड/राइट ऑपरेशन थ्रेड और मैसेज पर जाकर, ट्रैश को बायपास किया जा सकता है. | सभी देशों/इलाकों में उपलब्ध नहीं है |
https://www.googleapis.com/auth/gmail.metadata |
लेबल, इतिहास के रिकॉर्ड, और ईमेल समेत संसाधनों का मेटाडेटा पढ़ें मैसेज के हेडर शामिल होंगे, लेकिन मैसेज का मुख्य हिस्सा या अटैचमेंट शामिल नहीं होंगे. | सभी देशों/इलाकों में उपलब्ध नहीं है |
https://www.googleapis.com/auth/gmail.settings.basic |
मूल मेल सेटिंग प्रबंधित करें. | सभी देशों/इलाकों में उपलब्ध नहीं है |
https://www.googleapis.com/auth/gmail.settings.sharing |
संवेदनशील मेल सेटिंग प्रबंधित करें, जिसमें फ़ॉरवर्ड करने के नियम और उपनाम शामिल हैं.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है ध्यान दें:इस दायरे से सुरक्षित कार्रवाइयां सिर्फ़ एडमिन के इस्तेमाल के लिए है. यह सुविधा सिर्फ़ Google Workspace के ग्राहकों के लिए उपलब्ध है पूरे डोमेन के लोगों को डेटा का ऐक्सेस देने की सुविधा वाले सेवा खाते का इस्तेमाल करें. |
सभी देशों/इलाकों में उपलब्ध नहीं है |
https://mail.google.com/ |
खाते के मेलबॉक्स तक का पूरा ऐक्सेस, जिसमें इन्हें हमेशा के लिए मिटाना भी शामिल है थ्रेड और मैसेज इस दायरे के लिए सिर्फ़ तब अनुरोध किया जाना चाहिए, जब आपका ऐप्लिकेशन इसे बायपास करने के लिए, थ्रेड और मैसेज को तुरंत और हमेशा के लिए मिटाना होगा ट्रैश; बाकी सभी कार्रवाइयां, बिना अनुमति वाले दायरों के साथ की जा सकती हैं. | सभी देशों/इलाकों में उपलब्ध नहीं है |
ऊपर दी गई टेबल में मौजूद, इस्तेमाल कॉलम में हर दायरे की संवेदनशीलता के बारे में बताया गया है, नीचे दी गई परिभाषाओं के मुताबिक:
गैर-संवेदनशील—ये दायरे अनुमति देने का ऐक्सेस. साथ ही, ऐप्लिकेशन की सिर्फ़ बुनियादी पुष्टि करने की ज़रूरत होती है. जानकारी के लिए इस ज़रूरी शर्त के बारे में ज़्यादा जानने के लिए, पुष्टि करने का तरीका.
संवेदनशील—ये दायरे, Google उपयोगकर्ता का डेटा ऐक्सेस करने की अनुमति देते हैं. साथ ही, इनके लिए ज़रूरी है की पुष्टि की जा सकती है. इस ज़रूरी शर्त के बारे में जानकारी के लिए, देखें Google API सेवाएं: उपयोगकर्ता के डेटा से जुड़ी नीति. इन दायरों के लिए, सुरक्षा से जुड़ी जांच की ज़रूरत नहीं होती.
प्रतिबंधित—ये दायरे, Google उपयोगकर्ता के डेटा को बड़े पैमाने पर ऐक्सेस करते हैं और आपको प्रतिबंधित दायरे की पुष्टि करने की ज़रूरत होगी. इसके लिए इस ज़रूरी शर्त के बारे में जानकारी देखें, तो Google API सेवाएं: उपयोगकर्ता के डेटा से जुड़ी नीति और एपीआई के चुनिंदा दायरों के लिए अन्य ज़रूरी शर्तें. अगर सर्वर पर, प्रतिबंधित स्कोप का डेटा सेव किया जाता है (या ट्रांसमिट किया जाता है), तो आपको सुरक्षा जांच की ज़रूरत है.
ऐसी अतिरिक्त जानकारी जो तब लागू होती है, जब आप Gmail API के इस्तेमाल और उसके ऐक्सेस को कंट्रोल करते हैं उपयोगकर्ता के डेटा को ऐक्सेस करने का अनुरोध यहां देखा जा सकता है: Gmail API सेवाओं का उपयोगकर्ता का डेटा और डेवलपर की नीति.
अगर आपके ऐप्लिकेशन को किसी अन्य Google API का ऐक्सेस चाहिए, तो उन दायरों की जानकारी भी शामिल कर सकती है. Google API के दायरों के बारे में ज़्यादा जानकारी पाने के लिए, देखें Google API ऐक्सेस करने के लिए, OAuth 2.0 का इस्तेमाल करना.
OAuth से पुष्टि
कुछ संवेदनशील OAuth दायरों का इस्तेमाल करने के लिए, आपको अपने ऐप्लिकेशन को इंस्टॉल करने की ज़रूरत पड़ सकती है Google की OAuth की पुष्टि करने की प्रक्रिया. OAuth की पुष्टि से जुड़े अक्सर पूछे जाने वाले सवाल पढ़ें यह तय करने के लिए कि आपके ऐप्लिकेशन की पुष्टि कब की जानी चाहिए और किस तरह की की पुष्टि करना ज़रूरी है. यह भी देखें Google API सेवाएं: उपयोगकर्ता के डेटा से जुड़ी नीति.