तुमच्या अ‍ॅपला Google Sheets कसे जोडायचे

तुमच्या अ‍ॅपला Google Sheets जोडण्यासाठी, Google Cloud प्रोजेक्टमध्ये Google Sheets API सक्षम करा, सर्व्हिस अकाउंट तयार करा, स्प्रेडशीट सर्व्हिस अकाउंटच्या ईमेल पत्त्यासोबत शेअर करा, आणि त्याची की सर्व्हर-बाजूचा सिक्रेट म्हणून साठवा. मग तुमचा सर्व्हर spreadsheets.values.get ने ओळी वाचतो आणि spreadsheets.values.append ने ओळी जोडतो. वापरकर्त्यांना स्वतःच्या शीट जोडायच्या असतील तर OAuth वापरा, आणि शीट पूर्णपणे सार्वजनिक असेल तर वाचनासाठी साधी API की पुरेशी आहे.

हे मार्गदर्शक कोणती पद्धत योग्य आहे, तुम्हाला लागणारे कॉल्स, कोटा आणि अडचणी, आणि AI अ‍ॅप बिल्डरसाठी प्रॉम्प्ट्स कव्हर करते. Google तपशील सप्टेंबर 2026 पर्यंत Google च्या डेव्हलपर डॉक्युमेंटेशनमधून घेतले आहेत.

शीट जोडण्याची कारणे

सामान्य कारणे:

• टीमचा वर्कफ्लो ठेवणे. कर्मचारी किंमत यादी किंवा वेळापत्रक Sheets मध्येच संपादित करत राहतात; अ‍ॅप ते दाखवते.
• लोक आधीच जिथे पाहतात तिथे डेटा गोळा करणे. नवीन साइनअप, ऑर्डर किंवा फॉर्म प्रतिसाद ओळी म्हणून येतात.
• रिपोर्टिंग. स्प्रेडशीटमध्ये जगणाऱ्या लोकांसाठी अ‍ॅपचा डेटा शीटमध्ये निर्यात करणे.
• पायरीचा दगड. शीटपासून सुरुवात करा, मग योग्य डेटाबेसकडे जा. स्प्रेडशीटचे अ‍ॅपमध्ये रूपांतर कसे करायचे पहा.

Google ला तुमचे अ‍ॅप कसे साइन इन करते ते निवडा

Google च्या credentials मार्गदर्शकात तीन प्रकार वर्णन केले आहेत:

बहुतेक अ‍ॅप्ससाठी सर्व्हिस अकाउंट योग्य पर्याय आहे: एक क्रेडेन्शियल सेट, तुमच्या मालकीचा, फक्त तुम्ही स्पष्टपणे शेअर केलेल्या शीट्सवर प्रवेशासह.

सर्व्हिस अकाउंटसह पायरीपायरीने

1. Google Cloud प्रोजेक्ट तयार करा किंवा निवडा आणि Google Sheets API सक्षम करा.
2. सर्व्हिस अकाउंट आणि त्याची की तयार करा. की एक JSON फाइल आहे; तिला पासवर्डसारखे हाताळा.
3. स्प्रेडशीट सर्व्हिस अकाउंटच्या ईमेल पत्त्यासोबत शेअर करा, फक्त-वाचन असेल तर Viewer म्हणून, लिहायचे असेल तर Editor म्हणून. Google च्या मार्गदर्शकानुसार हे नेहमीच्या शेअरिंग स्क्रीनवरून होते.
4. की सर्व्हरवर सिक्रेट म्हणून साठवा, उदाहरणार्थ GOOGLE_SERVICE_ACCOUNT_JSON, आणि स्प्रेडशीट ID (शीटच्या URL मधील लांब स्ट्रिंग) SHEET_ID म्हणून.
5. सर्व्हरवरून API कॉल करा तुमच्या भाषेच्या Google क्लायंट लायब्ररीने.
6. वाचन कॅश करा, अनेक अभ्यागत एकच डेटा पाहत असतील तर कोटा गाठू नये म्हणून.

तुम्ही वापराल ते कॉल्स

Google च्या values वाचन-लेखन मार्गदर्शकातून:

रेंज 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 मर्यादा पानावर:

प्रति-मिनिट कोटात राहिलात तर दैनिक मर्यादा नाही. मर्यादा ओलांडल्यास 429: Too many requests येते, आणि Google truncated exponential backoff ची शिफारस करते: प्रत्येक अयशस्वी प्रयत्नानंतर जास्त वेळ थांबा, यादृच्छिक विलंबासह, कमाल मर्यादेपर्यंत. 180 सेकंदांपेक्षा जास्त चालणारी एकच विनंती टाइम आउट होते.

व्यवहारात: प्रत्येक पेज व्ह्यूवर API कॉल करू नका. शीटचा डेटा किमान एक मिनिट कॅश करा, batchGet ने वाचन एकत्र करा, आणि शक्य तिथे लेखन एकत्र करा.

पर्याय आणि तडजोडी

अनेक वापरकर्ते किंवा संवेदनशील डेटा असलेल्या कोणत्याही गोष्टीसाठी, डेटाबेस हा अधिक चांगला सत्य स्रोत आहे. डेटाबेस म्हणजे काय पहा.

तुमच्या AI बिल्डरला द्यायचे प्रॉम्प्ट्स

शीट वाचण्यासाठी:

आमच्या Google शीटचा "Menu" टॅब मेनू पानावर दाखवा. सर्व्हरवरून Google Sheets API वापरा, ज्याची सर्व्हिस अकाउंट JSON की GOOGLE_SERVICE_ACCOUNT_JSON सिक्रेटमध्ये आहे, आणि स्प्रेडशीट ID SHEET_ID मध्ये आहे. Menu!A2:D रेंज वाचा (नाव, वर्णन, किंमत, श्रेणी). निकाल 5 मिनिटांसाठी कॅश करा. API अयशस्वी झाल्यास शेवटची कॅश केलेली आवृत्ती दाखवा. की कधीही ब्राउझरला पाठवू नका.

ओळी लिहिण्यासाठी:

कोणी संपर्क फॉर्म सबमिट केल्यावर तो आमच्या डेटाबेसमध्ये साठवा, आणि "Leads" टॅबमध्ये एक ओळ (तारीख, नाव, ईमेल, संदेश) spreadsheets.values.append वापरून valueInputOption RAW सह जोडा. Google 429 देत असेल तर exponential backoff ने पुन्हा प्रयत्न करा; तरीही अयशस्वी झाल्यास लीड डेटाबेसमध्ये ठेवा आणि नंतर पुन्हा प्रयत्न करा.

सामान्य चुका

• सर्व्हिस अकाउंट ईमेलसोबत शीट शेअर करायला विसरणे. की योग्य असली तरी API परवानगी त्रुटी देते.
• फ्रंटएंड किंवा रेपॉझिटरीमध्ये की. JSON की त्यासोबत शेअर केलेल्या प्रत्येक शीटवर प्रवेश देते. API की सुरक्षित कशा ठेवायच्या पहा.
• वापरकर्ता इनपुटसाठी USER_ENTERED वापरणे, ज्यामुळे फॉर्म्युला इंजेक्शन शक्य होते.
• प्रत्येक विनंतीवर API कॉल करणे आणि पहिल्या ट्रॅफिक स्पाइकवरच प्रति-मिनिट कोटा गाठणे.
• कॉलम स्थानांवर अवलंबून राहणे. कोणी कॉलम घातला आणि अ‍ॅप चुकीचा डेटा वाचते. हेडर ओळ वाचा आणि नावानुसार मॅप करा, किंवा हेडर लॉक करा.
• आवश्यकतेपेक्षा जास्त शीट शेअर करणे. "लिंक असलेल्या कोणालाही" शीट सार्वजनिक करते.
• शीटला बहु-वापरकर्ता डेटाबेस म्हणून वापरणे. एकाचवेळी लेखन आणि गहाळ परवानग्यांमुळे डेटा हरवतो किंवा उघड होतो.

चेकलिस्ट

• Sheets API सक्षम; सर्व्हिस अकाउंट तयार
• शीट सर्व्हिस अकाउंट ईमेलसोबत, आवश्यक असलेल्या सर्वात कमी भूमिकेसह शेअर
• की आणि शीट ID सर्व्हर-बाजूचे सिक्रेट म्हणून साठवलेले
• सर्व कॉल्स सर्व्हरवरून
• रेंजमध्ये टॅबची नावे वापरलेली
• वापरकर्त्याने दिलेल्या मजकुरासाठी RAW वापरलेले
• वाचन कॅश; 429 बॅकऑफसह हाताळलेले
• Sheets उपलब्ध नसेल तर अ‍ॅप सौम्यपणे कार्य करते
• कोणती बाजू सत्य स्रोत आहे ते ठरवलेले

Mythex मध्ये Google Sheets

Mythex मध्ये Sheets सोबत काम करण्याचे दोन वेगळे मार्ग आहेत. कनेक्टर्स तुमचे Google खाते Mythex शी जोडतात, जेणेकरून तुम्ही बांधत असताना एजंट ते वापरू शकतो, उदाहरणार्थ शीट वाचून त्यावरून डॅशबोर्ड बनवणे; डॉक्स सांगतात की क्रेडेन्शियल Mythex च्या कनेक्शन सेवेतच राहते आणि तुमच्या कोडमध्ये कधीच जात नाही (पहा कनेक्टर्स, आणि Google जी प्रत्येक परवानगी विचारते ती मंजूर करा). प्रकाशित अ‍ॅपने स्वतःहून शीट वाचावी किंवा लिहावी यासाठी, या मार्गदर्शकातील पद्धत विश्वसनीय आहे: सर्व्हिस अकाउंट की प्रोजेक्ट सिक्रेट म्हणून साठवा आणि तुमच्या सर्व्हरवरून Sheets API कॉल करा, कोणताही API इंटिग्रेट करा मध्ये दाखवल्याप्रमाणे. शीटची मर्यादा ओलांडत असाल, तर एजंटला डेटा प्रोजेक्टच्या डेटाबेसमध्ये हलवायला आणि त्यावर डॅशबोर्ड बांधायला सांगा.

प्रश्न