---
title: "Gmail से OTP कैसे निकालें: अपने ऐप का API से परीक्षण"
description: "अपने परीक्षण Gmail में आया OTP Mailera API से पढ़ें। ऐप पासवर्ड, सीमित read कुंजी, प्रेषक और समय के फ़िल्टर तथा सिंक की जाँच के चरण समझें।"
url: https://mailera.app/hi/blog/gmail-otp-api
published: 2026-10-25
updated: 2026-10-25
---

# Gmail से OTP कैसे निकालें: अपने ऐप का API से परीक्षण

अपने परीक्षण Gmail में आए सत्यापन कोड को Mailera API से पढ़ें। सही संदेश चुनने, पुराने कोड से बचने और सिंक की समस्या पहचानने के लिए ज़रूरी चरण।

## Gmail API और Mailera के OTP API में क्या अंतर है?

यहाँ OTP से मतलब आपके ऐप के भेजे हुए ईमेल में मौजूद एक बार इस्तेमाल होने वाला सत्यापन कोड है। कोड बनाना और भेजना, प्राप्त मेल से उसे निकालना, फिर ऐप में उसकी वैधता जाँचना अलग काम हैं। इस प्रक्रिया में Mailera का काम प्राप्त मेल से कोड पढ़ना है।

| पहलू | सीधे Gmail API | Mailera का OTP API |
| --- | --- | --- |
| कनेक्शन | Google OAuth और Gmail API scopes | Gmail के लिए ऐप पासवर्ड और IMAP |
| संदेश पढ़ना | `users.messages.list`, फिर विवरण के लिए `users.messages.get` | जुड़े मेलबॉक्स पर `GET /mailboxes/{id}/otp` |
| पहुँच की अनुमति | Google के authorization scopes | Mailera की `read` अनुमति और मेलबॉक्स समूह का दायरा |
| परिणाम का उपयोग | संदेश से कोड निकालने की व्यवस्था आपको करनी है | नवीनतम OTP माँगने के लिए अलग endpoint है |

Google का [Gmail API scopes दस्तावेज़](https://developers.google.com/workspace/gmail/api/auth/scopes) बताता है कि ऐप को कितने दायरे की पहुँच मिलेगी। उसके [`users.messages.list` संदर्भ](https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.messages/list) के अनुसार सूची में संदेश के केवल `id` और `threadId` आते हैं; अतिरिक्त विवरण `messages.get` से मिलता है। सूची माँगना अपने आप OTP निकालना नहीं है।

जुड़े मेलबॉक्स से सामान्य संदेश पढ़ने के लिए `GET /mailboxes/{id}/messages` या सीधे नवीनतम कोड के लिए `GET /mailboxes/{id}/otp` इस्तेमाल करें। कनेक्शन की ज़रूरतें [Gmail प्रदाता पेज](https://mailera.app/hi/providers/gmail) पर हैं। दूसरे मेलबॉक्स के लिए यही काम करना हो तो [अपने इनबॉक्स से OTP पढ़ने की सामान्य गाइड](https://mailera.app/hi/blog/email-otp-api) देखें।

![परीक्षण ऐप से Gmail, Mailera सिंक और OTP अनुरोध होते हुए ऐप में कोड की जाँच तक की प्रक्रिया](https://mailera.app/media/174dd2c765608d03/gmail-otp-api-otp-flow-hi-1200.jpg)
_Gmail में ईमेल पहुँचना और Mailera में उसका सिंक होना अलग चरण हैं।_

## परीक्षण वाला Gmail मेलबॉक्स कैसे जोड़ें?

पहले ऐसा Gmail खाता चुनें जो आपका हो और परीक्षण के लिए रखा गया हो। उसे अलग Mailera समूह में रखें, ताकि बाद में API कुंजी को केवल उसी समूह तक पहुँच दी जा सके।

1. **Google खाते की तैयारी करें।** ऐप पासवर्ड (app password) के लिए दो-चरणीय सत्यापन चालू होना चाहिए। [Google के ऐप पासवर्ड निर्देश](https://support.google.com/accounts/answer/185833) देखें। केवल security keys वाला दो-चरणीय सत्यापन, संगठन का खाता या Advanced Protection होने पर यह विकल्प नहीं दिख सकता। संगठन के खाते में दो-चरणीय सत्यापन चालू नहीं कर पा रहे हों तो [Google के निर्देशों के अनुसार व्यवस्थापक से सहायता लें](https://support.google.com/accounts/answer/185839)।
2. **मेलबॉक्स जोड़ने का फ़ॉर्म खोलें।** Admin या Leader भूमिका से **मेलबॉक्स → मेलबॉक्स जोड़ें** खोलें और **एक मेलबॉक्स** टैब चुनें। **ईमेल पता** में अपना परीक्षण पता भरें। Mailera प्रदाता को अपने-आप पहचानता है; न पहचाने जाने पर **या प्रदाता चुनें** से Gmail चुनें। इसके बाद **जारी रखें** दबाएँ।
3. **ऐप पासवर्ड दर्ज करें।** **कनेक्शन विवरण** के **पासवर्ड** फ़ील्ड में सामान्य Google पासवर्ड नहीं, ऐप पासवर्ड दें। **मेलबॉक्स समूह** में परीक्षण वाला समूह चुनें और **जाँचें और कनेक्ट करें** दबाएँ। यह कनेक्शन की जाँच है; इससे कोई ईमेल नहीं भेजा जाता।
4. **पहली लोडिंग की पुष्टि करें।** सफल कनेक्शन के बाद Mailera अपनी संदेश-संग्रह अवधि के भीतर के संदेश नए से पुराने क्रम में लोड करता है। अपने ऐप से परीक्षण ईमेल भेजें और **एकीकृत इनबॉक्स** में उसके दिखने का इंतज़ार करें।

यदि प्राप्ति की जाँच सफल है लेकिन भेजने की जाँच विफल होती है, तो Mailera **केवल प्राप्ति मोड में सहेजें** का विकल्प देता है। इस गाइड के लिए यह पर्याप्त है, क्योंकि आपको अपने ऐप का भेजा हुआ मेल पढ़ना है, Mailera से सत्यापन ईमेल भेजना नहीं।

![Gmail जोड़ने के लिए ऐप पासवर्ड और परीक्षण मेलबॉक्स समूह वाला कनेक्शन फ़ॉर्म](https://mailera.app/media/18bafa98aa25d307/oauth-mailera-ai-add-mailbox-hi-1200.jpg)
_पासवर्ड फ़ील्ड में Google का सामान्य पासवर्ड नहीं, ऐप पासवर्ड दें।_

Google किसी ऐप में उपलब्ध होने पर “Sign in with Google” इस्तेमाल करने की सलाह देता है। Mailera में Gmail को इस तरह जोड़ने के लिए ऐप पासवर्ड लगता है। अलग-अलग प्रदाताओं का अंतर [एजेंट मेलबॉक्स के ऐप पासवर्ड वाली गाइड](https://mailera.app/hi/blog/email-app-password-oauth) में देखें। इसे Outlook पर लागू न करें: [Outlook के लिए OAuth वाला मार्ग](https://mailera.app/hi/blog/outlook-app-password-not-working) अलग है।

## API से सही मेलबॉक्स का सत्यापन कोड कैसे लें?

### 1. परीक्षण समूह तक सीमित कुंजी बनाएँ

**सेटिंग्स** में API key टैब खोलें और **API key बनाएँ** चुनें। **पहचानने योग्य नाम** दें, **मेलबॉक्स का दायरा** केवल परीक्षण समूह तक रखें और `read` अनुमति चुनें। पढ़ने के इस काम के लिए `send`, `move` या `manage` न जोड़ें।

कुंजी केवल एक बार दिखाई जाती है: **API key बन गई — अभी कॉपी करें**। उसे सुरक्षित पर्यावरण चर `$MAILERA_API_KEY` में रखें, साझा नोट या स्रोत कोड में नहीं। API के उपयोग का परिचय [डेवलपर पेज](https://mailera.app/hi/developers) पर और endpoint संदर्भ [API दस्तावेज़ों](https://mailera.app/hi/docs) में है।

![केवल परीक्षण मेलबॉक्स समूह और पढ़ने की अनुमति तक सीमित API कुंजी का फ़ॉर्म](https://mailera.app/media/a8160b488a693dcc/otp-gmail-api-gmail-read-api-key-hi-1200.jpg)
_read अनुमति के साथ मेलबॉक्स का दायरा भी सीमित रखें।_

### 2. मेलबॉक्स की पहचान करें

यह अनुरोध उस कुंजी के दायरे में उपलब्ध मेलबॉक्स की सूची माँगता है:

```bash
curl --get 'https://mailera.app/api/public/v1/mailboxes' \
  --header "Authorization: Bearer $MAILERA_API_KEY"
```

उत्तर की `data` सूची में अपने परीक्षण पते का `email` पहचानें और उसी प्रविष्टि का `id` पर्यावरण चर `$MAILBOX_ID` में रखें। पहली प्रविष्टि को बिना पता देखे न चुनें। सूची का `last_sync_at` आगे सिंक की जाँच में भी काम आएगा।

### 3. अपने ऐप से नया सत्यापन ईमेल भेजें

उसी परीक्षण पते पर नया कोड माँगें और अनुरोध का समय दर्ज करें। पहली जाँच में एक समय पर एक ही सत्यापन प्रक्रिया चलाएँ। इससे एक ही प्रेषक और विषय वाले कई संदेशों के बीच भ्रम कम होगा।

### 4. OTP अनुरोध में फ़िल्टर दें

नीचे `verify@example.com` और `Test verification` उदाहरण हैं। इन्हें अपने परीक्षण ऐप के वास्तविक प्रेषक और विषय से बदलें। `since_minutes=5` इस उदाहरण की खोज अवधि है, कोई डिफ़ॉल्ट या OTP की वैधता अवधि नहीं।

```bash
curl --get "https://mailera.app/api/public/v1/mailboxes/$MAILBOX_ID/otp" \
  --header "Authorization: Bearer $MAILERA_API_KEY" \
  --data-urlencode 'from=verify@example.com' \
  --data-urlencode 'subject=Test verification' \
  --data-urlencode 'since_minutes=5'
```

`--data-urlencode` से विषय में मौजूद खाली जगहों जैसे अक्षरों को URL पैरामीटर में भेजा जा सकता है। तीनों फ़िल्टर अलग गलतियों को कम करने के लिए हैं:

| पैरामीटर | किस आधार पर खोज सीमित करें | क्या सावधानी रखें |
| --- | --- | --- |
| `from` | परीक्षण ईमेल का प्रेषक | ऐप का नाम देखकर पता अनुमान न लगाएँ; प्राप्त संदेश का प्रेषक देखें |
| `subject` | परीक्षण ईमेल का विषय | दूसरे प्रकार के मेल को सत्यापन संदेश न समझें |
| `since_minutes` | हाल की समय-सीमा | इतनी बड़ी अवधि न चुनें कि पुराने परीक्षण भी उसमें आ जाएँ |

कोड मिलने के बाद उसे अपने परीक्षण ऐप की उसी सत्यापन प्रक्रिया में दें। परीक्षण तभी सफल मानें जब ऐप उसे स्वीकार करे। नवीनतम कोड मिल जाना पर्याप्त नहीं: सही सत्र और कोड की समाप्ति की जाँच जारी करने वाले ऐप को करनी है।

## आम गलतियाँ: OTP नहीं मिल रहा या पुराना मिल रहा है?

पहले पता करें कि संदेश Gmail तक नहीं पहुँचा, Mailera में अभी सिंक नहीं हुआ, या आपका अनुरोध गलत संदेश खोज रहा है। हर स्थिति में नया OTP माँगते रहना जाँच को और उलझा सकता है।

| समस्या | क्या जाँचें | अगला कदम |
| --- | --- | --- |
| दूसरे परीक्षण का कोड मिलता है | `$MAILBOX_ID` से जुड़ा `email` | `GET /mailboxes` में सही पता दोबारा पहचानें |
| Gmail में मेल है, OTP नहीं मिलता | वास्तविक प्रेषक और विषय | `from` और `subject` उसी संदेश के अनुसार भरें |
| पुराना कोड मिलता है | अनुरोध का समय और खोज अवधि | अवधि घटाएँ; उसी मेलबॉक्स पर समानांतर परीक्षण अलग करें |
| नया मेल Mailera में नहीं दिखता | `last_sync_at` और कनेक्शन स्थिति | सिंक की स्थिति जाँचें, फिर सीमित समय तक दोबारा अनुरोध करें |
| Inbox में संदेश नहीं है | संदेश का फ़ोल्डर | `placement` से Inbox या Spam में स्थान जाँचें |
| पहले चलता था, अब कनेक्शन विफल है | क्या Google पासवर्ड बदला था? | Google पासवर्ड बदलने पर ऐप पासवर्ड रद्द होते हैं; नया ऐप पासवर्ड देकर फिर जोड़ें |

स्थिति के लिए `GET /mailboxes/{id}/status` उपलब्ध है। Gmail के मामले में यह नवीनतम सिंक पर आधारित है, उसी क्षण किया गया सीधा Google साइन-इन परीक्षण नहीं। इसलिए इसे `last_sync_at` के साथ पढ़ें।

संदेश का स्थान जाँचने के लिए OTP अनुरोध वाले फ़िल्टर ही इस्तेमाल कर सकते हैं:

```bash
curl --get "https://mailera.app/api/public/v1/mailboxes/$MAILBOX_ID/placement" \
  --header "Authorization: Bearer $MAILERA_API_KEY" \
  --data-urlencode 'from=verify@example.com' \
  --data-urlencode 'subject=Test verification' \
  --data-urlencode 'since_minutes=5'
```

Spam में संदेश मिले तो केवल परीक्षण आगे बढ़ाने के इरादे से उसे Inbox में स्थानांतरित न करें, क्योंकि इससे असली placement परिणाम बदल जाएगा और आगे की जाँच गुमराह करेगी। फ़ोल्डर के संदेश पढ़ने के लिए `GET /mailboxes/{id}/messages` भी उपलब्ध है। संदेश स्थानांतरित करना अलग कार्रवाई है और उसके लिए `move` अनुमति चाहिए।

दोबारा जाँचने से पहले अपने परीक्षण की अंतिम समय-सीमा तय करें। उसके भीतर अंतराल देकर OTP अनुरोध दोहराएँ; सीमा पूरी होने पर परीक्षण रोकें और स्थान तथा सिंक की स्थिति दर्ज करें, कोड नहीं। `POST /mailboxes/{id}/sync` से सिंक माँगा जा सकता है, लेकिन इसके लिए अलग `sync` अनुमति चाहिए। ऊपर बनाई गई `read` कुंजी से यह अनुरोध न चलाएँ।

## Mailera की सीमाएँ क्या हैं?

Mailera मौजूदा मेलबॉक्स जोड़ता है; नया Gmail खाता या ईमेल पता नहीं बनाता। बैकग्राउंड जाँच की आवृत्ति मेलबॉक्स के उपयोग के अनुसार बदलती है, इसलिए तत्काल सिंक या तत्काल OTP मिलने पर निर्भर परीक्षण न बनाएँ। Inbox में पहुँचने की गारंटी भी नहीं है।

ऐप पासवर्ड की उपलब्धता Google और आपके संगठन की नीति पर निर्भर है। Mailera इन पाबंदियों को बदल नहीं सकता। मेल से कोड पढ़ लेने पर भी उसकी वैधता और सही सत्र की ज़िम्मेदारी आपके ऐप की ही रहती है।

## कोड और मेलबॉक्स की पहुँच सुरक्षित कैसे रखें?

केवल अपने परीक्षण मेलबॉक्स का उपयोग करें। उत्पादन उपयोगकर्ताओं के सत्यापन कोड इस प्रक्रिया में न लाएँ। स्क्रीनशॉट, साझा लॉग और परीक्षण की रिपोर्ट से ऐप पासवर्ड, API कुंजी, निजी ईमेल पते और OTP छिपाएँ।

`read` अनुमति केवल OTP तक सीमित नहीं है; इससे दायरे में आने वाले मेलबॉक्स के संदेश भी पढ़े जा सकते हैं। इसलिए अलग परीक्षण समूह चुनना ज़रूरी है। परीक्षण की ज़रूरत के हिसाब से तय करें कि कुंजी कब समाप्त होगी और काम पूरा होने पर अनावश्यक कुंजी रद्द करें। पहुँच संबंधी जानकारी [Mailera के सुरक्षा पेज](https://mailera.app/hi/security) पर देखें।

यदि कोई AI agent अनुरोध चला रहा है, तो आने वाले ईमेल को अविश्वसनीय डेटा मानें, निर्देश नहीं। संदेश में लिखे आदेशों के आधार पर कुंजी साझा करने या दूसरा अनुरोध चलाने की अनुमति न दें। agent को न्यूनतम अनुमति दें और ईमेल भेजने जैसी कार्रवाई से पहले उपयोगकर्ता की पुष्टि लें।

**यह काम API से करें** — इस लेख की हर कार्रवाई REST API के ज़रिए उपलब्ध है, साथ में curl के उदाहरण, API key और webhook भी हैं। [API दस्तावेज़ देखें](https://mailera.app/hi/docs)