Google Sheets को अपनी ऐप से कैसे जोड़ें

Google Sheets को अपनी ऐप से जोड़ने के लिए, एक Google Cloud प्रोजेक्ट में Google Sheets API चालू करें, एक service account बनाएं, स्प्रेडशीट को service account के ईमेल पते के साथ शेयर करें, और उसकी key को एक सर्वर-साइड secret के रूप में सहेजें। फिर आपका सर्वर spreadsheets.values.get से पंक्तियां पढ़ता है और spreadsheets.values.append से पंक्तियां जोड़ता है। अगर उपयोगकर्ताओं को अपनी खुद की शीट जोड़नी है, तो इसके बजाय OAuth इस्तेमाल करें, और अगर शीट पूरी तरह सार्वजनिक है, तो पढ़ने के लिए एक सरल API key काफ़ी है।

यह गाइड बताती है कि कौन सा तरीका फिट बैठता है, आपको कौन सी कॉल चाहिए, कोटा और सावधानियां क्या हैं, और AI ऐप बिल्डर के लिए प्रॉम्प्ट। Google के विवरण सितंबर 2026 तक के Google के डेवलपर डॉक्यूमेंटेशन से लिए गए हैं।

शीट जोड़ने की ज़रूरत क्यों

आम कारण:

टीम का वर्कफ़्लो बनाए रखें। स्टाफ़ Sheets में मूल्य सूची या शेड्यूल संपादित करता रहता है; ऐप उसे दिखाती है।
डेटा वहीं इकट्ठा करें जहां लोग पहले से देखते हैं। नए साइनअप, ऑर्डर या फ़ॉर्म जवाब पंक्तियों के रूप में आते हैं।
रिपोर्टिंग। ऐप का डेटा उन लोगों के लिए शीट में एक्सपोर्ट करें जो स्प्रेडशीट में काम करते हैं।
एक सीढ़ी। शीट से शुरू करें, फिर एक उचित डेटाबेस पर जाएं। देखें स्प्रेडशीट को ऐप में कैसे बदलें।

चुनें कि आपकी ऐप Google में कैसे साइन इन करती है

Google की credentials गाइड तीन प्रकार बताती है:

Credential	यह किस तक पहुंच सकता है	सबसे अच्छा किसके लिए
API key	केवल सार्वजनिक रूप से उपलब्ध डेटा, जैसे “Anyone with the link” से शेयर फ़ाइलें	सार्वजनिक शीट पढ़ना
Service account	आपकी ऐप का अपना डेटा, या service account के ईमेल के साथ शेयर की गई खास फ़ाइलें	आपकी ऐप का आपकी शीट पढ़ना और लिखना
OAuth client ID	उपयोगकर्ता की अपनी फ़ाइलें, उसकी सहमति के बाद	हर उपयोगकर्ता को अपनी शीट जोड़ने देना

ज़्यादातर ऐप के लिए service account सही विकल्प है: एक ही credentials का सेट, आपके स्वामित्व में, और सिर्फ उन्हीं शीट तक पहुंच जो आप उसके साथ स्पष्ट रूप से शेयर करते हैं।

Service account के साथ चरण-दर-चरण

Google Cloud प्रोजेक्ट बनाएं या चुनें और Google Sheets API चालू करें।
एक service account और उसकी key बनाएं। key एक JSON फ़ाइल है; उसे पासवर्ड की तरह समझें।
स्प्रेडशीट को service account के ईमेल पते के साथ शेयर करें: सिर्फ पढ़ने के लिए Viewer, या लिखने के लिए Editor। Google की गाइड कहती है कि यह सामान्य शेयरिंग स्क्रीन से होता है।
key को सर्वर पर एक secret के रूप में सहेजें, जैसे GOOGLE_SERVICE_ACCOUNT_JSON, और स्प्रेडशीट ID (शीट के URL में लंबी स्ट्रिंग) को SHEET_ID के रूप में।
सर्वर से API कॉल करें अपनी भाषा के लिए Google की client library के साथ।
पढ़ाई को कैश करें अगर बहुत सारे विज़िटर एक ही डेटा देखते हैं, ताकि आप कोटा तक न पहुंचें।

वे कॉल जो आप इस्तेमाल करेंगे

मूल्य पढ़ने और लिखने की Google की गाइड से:

मेथड	यह क्या करता है
`spreadsheets.values.get`	एक रेंज पढ़ता है, जैसे `Leads!A1:E`
`spreadsheets.values.batchGet`	एक अनुरोध में कई रेंज पढ़ता है
`spreadsheets.values.update`	एक खास रेंज में लिखता है
`spreadsheets.values.append`	एक टेबल में मौजूदा डेटा के बाद पंक्तियां जोड़ता है

रेंज A1 नोटेशन में लिखे जाते हैं। Google बताता है कि शीट नाम के बिना रेंज, जैसे A1:B2, पहली शीट पर लागू होती है, इसलिए जब कोई टैब का क्रम बदले तो आश्चर्य से बचने के लिए टैब का नाम साफ़ लिखें।

RAW बनाम USER_ENTERED

लिखने के लिए valueInputOption चाहिए:

RAW वही सहेजता है जो आप भेजते हैं, टेक्स्ट के रूप में। =1+2 टेक्स्ट =1+2 के रूप में सहेजा जाता है।
USER_ENTERED इनपुट को ऐसे मानता है जैसे Sheets में टाइप किया गया हो: तारीखें तारीखें बन जाती हैं और =1+2 एक फ़ॉर्मूला बन जाता है।

अगर आप वह टेक्स्ट लिख रहे हैं जो उपयोगकर्ताओं ने आपकी ऐप में टाइप किया है, तो RAW इस्तेमाल करें। USER_ENTERED के साथ कोई फ़ॉर्मूला जमा कर सकता है जो सहकर्मी के शीट खोलने पर चल जाए।

कोटा और त्रुटियां

सितंबर 2026 तक, Google के Sheets API सीमा पेज में ये सूचीबद्ध हैं:

सीमा	Read अनुरोध	Write अनुरोध
प्रति प्रोजेक्ट प्रति मिनट	300	300
प्रति उपयोगकर्ता प्रति प्रोजेक्ट प्रति मिनट	60	60

जब तक आप प्रति-मिनट कोटा में रहते हैं, कोई दैनिक सीमा नहीं है। सीमा पार करने पर 429: Too many requests आता है, और Google truncated exponential backoff की सलाह देता है: हर असफल प्रयास के बाद ज़्यादा देर तक रुकें, एक यादृच्छिक विलंब के साथ, एक अधिकतम तक। 180 सेकंड से ज़्यादा लेने वाला एक अनुरोध टाइम आउट हो जाता है।

व्यवहार में: हर पेज व्यू पर API को कॉल न करें। शीट के डेटा को एक मिनट या उससे ज़्यादा कैश करें, batchGet से पढ़ाई को बैच करें, और जहां हो सके लिखाई को बैच करें।

विकल्प और समझौते

तरीका	फ़ायदे	नुकसान
शीट को लाइव डेटा स्रोत के रूप में	स्टाफ़ परिचित टूल में संपादन करता है; बनाने के लिए कोई एडमिन स्क्रीन नहीं	कोटा, प्रति-पंक्ति अनुमतियां नहीं, कॉलम का नाम बदलने से आसानी से टूट जाता है
शीट को डेटाबेस में सिंक करना	तेज़, भरोसेमंद पढ़ाई; Sheets बंद हो तो भी ऐप चलती रहती है	एक सिंक जॉब और यह नियम चाहिए कि कौन सा पक्ष जीतता है
पहले डेटाबेस, शीट में एक्सपोर्ट	ऐप डेटा की मालिक है; शीट एक रिपोर्ट है	शीट में बदलाव वापस नहीं आते
बीच में ऑटोमेशन टूल	सरल फ़्लो के लिए बिना कोड	एक और सब्सक्रिप्शन; डीबग करना कठिन

बहुत सारे उपयोगकर्ताओं या संवेदनशील डेटा वाली किसी भी चीज़ के लिए, डेटाबेस सत्य का बेहतर स्रोत है। देखें डेटाबेस क्या है।

अपने AI बिल्डर को दिए जाने वाले प्रॉम्प्ट

शीट पढ़ना:

हमारी Google Sheet का “Menu” टैब मेनू पेज पर दिखाओ। सर्वर से Google Sheets API का उपयोग करो, एक service account के साथ जिसकी JSON key secret GOOGLE_SERVICE_ACCOUNT_JSON में है, और स्प्रेडशीट ID SHEET_ID में है। रेंज Menu!A2:D पढ़ो (नाम, विवरण, कीमत, श्रेणी)। परिणाम 5 मिनट के लिए कैश करो। अगर API विफल हो, तो आखिरी कैश किया हुआ संस्करण दिखाओ। key को कभी ब्राउज़र तक न भेजो।

पंक्तियां लिखना:

जब कोई संपर्क फ़ॉर्म भरे, तो उसे हमारे डेटाबेस में सहेजो और साथ ही “Leads” टैब में एक पंक्ति जोड़ो (तारीख, नाम, ईमेल, संदेश) spreadsheets.values.append के साथ valueInputOption RAW का उपयोग करते हुए। अगर Google 429 लौटाए, तो exponential backoff के साथ फिर कोशिश करो; अगर फिर भी विफल हो, तो लीड को डेटाबेस में रखो और बाद में फिर कोशिश करो।

आम गलतियां

शीट को service account के ईमेल के साथ शेयर करना भूल जाना। तब key सही होने पर भी API अनुमति त्रुटि लौटाता है।
Key फ़्रंटएंड या रिपॉज़िटरी में। JSON key उसके साथ शेयर की गई हर शीट तक पहुंच देती है। देखें API keys को सुरक्षित कैसे रखें।
उपयोगकर्ता इनपुट के लिए USER_ENTERED इस्तेमाल करना, जो फ़ॉर्मूला इंजेक्शन की अनुमति देता है।
हर अनुरोध पर API को कॉल करना और पहले ट्रैफ़िक उछाल पर प्रति-मिनट कोटा तक पहुंच जाना।
कॉलम की स्थिति पर निर्भर रहना। कोई कॉलम डाल देता है और ऐप गलत डेटा पढ़ती है। हेडर पंक्ति पढ़ें और नाम से मैप करें, या हेडर लॉक करें।
ज़रूरत से ज़्यादा व्यापक रूप से शीट शेयर करना। “Anyone with the link” उसे सार्वजनिक बना देता है।
शीट को मल्टी-यूज़र डेटाबेस की तरह इस्तेमाल करना। एक साथ लिखाई और गायब अनुमतियों से डेटा खोता या लीक होता है।

चेकलिस्ट

Sheets API चालू; service account बनाई गई
शीट service account के ईमेल के साथ सबसे कम ज़रूरी भूमिका में शेयर की गई
key और शीट ID सर्वर-साइड secrets के रूप में सहेजे गए
सारी कॉल सर्वर से की गईं
रेंज में टैब के नाम इस्तेमाल किए गए
उपयोगकर्ता द्वारा दिए गए टेक्स्ट के लिए RAW इस्तेमाल हुआ
पढ़ाई कैश की गई; 429 को backoff के साथ संभाला गया
Sheets उपलब्ध न हो तो ऐप सुचारु रूप से काम करती है
तय किया गया कि सत्य का स्रोत कौन सा पक्ष है

Mythex में Google Sheets

Mythex में Sheets के साथ काम करने के दो अलग तरीके हैं। Connectors आपके Google अकाउंट को Mythex से जोड़ते हैं ताकि एजेंट आपके बनाते समय उसका उपयोग कर सके, जैसे किसी शीट को पढ़कर उससे डैशबोर्ड बनाना; डॉक्स कहते हैं कि क्रेडेंशियल Mythex की कनेक्शन सेवा के पास रहता है और कभी आपके कोड में नहीं पहुंचता (देखें Connectors, और Google जो भी अनुमति मांगे उसे स्वीकार करने से पहले जांचें)। प्रकाशित ऐप के खुद शीट पढ़ने या लिखने के लिए, भरोसेमंद तरीका वही है जो इस गाइड में है: एक service account key को प्रोजेक्ट secret के रूप में सहेजना और सर्वर से Sheets API कॉल, जैसा किसी भी API को इंटीग्रेट करें में है। अगर आप शीट से आगे बढ़ रहे हैं, तो एजेंट से डेटा को प्रोजेक्ट के डेटाबेस में ले जाने को कहें और उसके ऊपर एक डैशबोर्ड बनवाएं।

सवाल

मेरी ऐप एक निजी Google Sheet कैसे पढ़ सकती है?

आम तरीका है Google Cloud service account: Sheets API चालू करें, service account और उसकी key बनाएं, फिर स्प्रेडशीट को service account के ईमेल पते के साथ Viewer या Editor के रूप में शेयर करें। आपका सर्वर उस key का उपयोग करता है, जो एक secret के रूप में सहेजी गई है, Sheets API कॉल करने के लिए।

क्या स्प्रेडशीट तक पहुंचने के लिए Google API key इस्तेमाल कर सकता हूं?

सिर्फ सार्वजनिक डेटा के लिए। Google की credentials गाइड कहती है कि API keys सार्वजनिक रूप से उपलब्ध डेटा तक गुमनाम पहुंच के लिए हैं, जैसे ऐसी फ़ाइलें जो लिंक वाले किसी भी व्यक्ति के साथ शेयर हों। निजी शीट के लिए service account या OAuth चाहिए।

Google Sheets API की सीमाएं क्या हैं?

सितंबर 2026 तक, Google प्रति प्रोजेक्ट प्रति मिनट 300 read और 300 write अनुरोध सूचीबद्ध करता है, और प्रति उपयोगकर्ता प्रति प्रोजेक्ट प्रति मिनट हर एक के लिए 60, बिना दैनिक सीमा के। सीमा पार होने पर 429 त्रुटि आती है; Google truncated exponential backoff की सलाह देता है।

क्या मुझे Google Sheets को अपनी ऐप का डेटाबेस बनाना चाहिए?

छोटी, कम ट्रैफ़िक वाली ऐप के लिए काम करता है, जहां लोग शीट में डेटा खुद भी बदलते हैं। बहुत सारे उपयोगकर्ताओं, बार-बार लिखने, रिकॉर्ड के बीच संबंधों या प्रति-उपयोगकर्ता अनुमतियों के लिए असली डेटाबेस ज़्यादा भरोसेमंद है, और आप फिर भी डेटा को शीट में एक्सपोर्ट कर सकते हैं।