మీ యాప్‌కు Google Sheets ఎలా కనెక్ట్ చేయాలి
మీ యాప్‌కు Google Sheets కనెక్ట్ చేయడానికి, Google Cloud ప్రాజెక్ట్‌లో Google Sheets APIని ఎనేబుల్ చేయండి, ఒక service account సృష్టించండి, స్ప్రెడ్‌షీట్‌ను service account ఇమెయిల్ చిరునామాతో షేర్ చేయండి, మరియు దాని కీని సర్వర్-సైడ్ సీక్రెట్గా నిల్వ చేయండి. మీ సర్వర్ తర్వాత spreadsheets.values.get తో వరుసలు చదువుతుంది మరియు spreadsheets.values.append తో వరుసలు జోడిస్తుంది. వినియోగదారులు తమ స్వంత షీట్‌లను కనెక్ట్ చేయాలంటే OAuth ఉపయోగించండి, మరియు షీట్ పూర్తిగా పబ్లిక్ అయితే చదవడానికి సాధారణ API కీ సరిపోతుంది.
ఈ గైడ్ ఏ పద్ధతి సరిపోతుందో, మీకు అవసరమైన కాల్స్, కోటాలు మరియు లోపాలు, మరియు AI యాప్ బిల్డర్ కోసం ప్రాంప్ట్‌లు వివరిస్తుంది. Google వివరాలు సెప్టెంబర్ 2026 నాటికి Google డెవలపర్ డాక్యుమెంటేషన్ నుండి తీసుకున్నవి.
షీట్‌ను కనెక్ట్ చేయడానికి కారణాలు
సాధారణ కారణాలు:
- జట్టు వర్క్‌ఫ్లో కొనసాగించడం. సిబ్బంది ధరల జాబితా లేదా షెడ్యూల్‌ను Sheetsలో ఎడిట్ చేస్తూనే ఉంటారు; యాప్ దాన్ని చూపిస్తుంది.
- ప్రజలు ఇప్పటికే చూసే చోట డేటా సేకరించడం. కొత్త సైన్-అప్‌లు, ఆర్డర్లు లేదా ఫారం స్పందనలు వరుసలుగా వస్తాయి.
- రిపోర్టింగ్. స్ప్రెడ్‌షీట్లలో జీవించే వ్యక్తుల కోసం యాప్ డేటాను షీట్‌కు ఎగుమతి చేయడం.
- ఒక మెట్టురాయి. షీట్‌తో మొదలుపెట్టి, తర్వాత సరైన డేటాబేస్‌కు మారండి. స్ప్రెడ్‌షీట్‌ను యాప్‌గా ఎలా మార్చాలి చూడండి.
Googleకు మీ యాప్ ఎలా సైన్ ఇన్ అవుతుందో ఎంచుకోండి
Google credentials గైడ్ మూడు రకాలను వివరిస్తుంది:
| Credential | ఏమి యాక్సెస్ చేయగలదు | ఉత్తమం |
|---|---|---|
| API key | "Anyone with the link" తో షేర్ చేసిన ఫైళ్లు వంటి పబ్లిక్‌గా అందుబాటులో ఉన్న డేటా మాత్రమే | పబ్లిక్ షీట్ చదవడం |
| Service account | మీ యాప్ యాజమాన్యంలోని డేటా, లేదా service account ఇమెయిల్‌కు షేర్ చేసిన నిర్దిష్ట ఫైళ్లు | మీ యాప్ మీ షీట్‌లను చదవడం మరియు రాయడం |
| OAuth client ID | వినియోగదారు అంగీకరించిన తర్వాత వారి స్వంత ఫైళ్లు | ప్రతి వినియోగదారు తమ షీట్‌లను కనెక్ట్ చేయడం |
చాలా యాప్‌లకు service account సరైన ఎంపిక: ఒకే క్రెడెన్షియల్ సెట్, మీ యాజమాన్యంలో, మీరు స్పష్టంగా షేర్ చేసిన షీట్‌లకు మాత్రమే యాక్సెస్.
Service accountతో దశలవారీగా
- Google Cloud ప్రాజెక్ట్ సృష్టించండి లేదా ఎంచుకోండి మరియు Google Sheets APIని ఎనేబుల్ చేయండి.
- Service account మరియు దాని కీని సృష్టించండి. కీ ఒక JSON ఫైల్; పాస్‌వర్డ్ లాగా చూడండి.
- స్ప్రెడ్‌షీట్‌ను service account ఇమెయిల్‌తో షేర్ చేయండి — చదవడానికి మాత్రమే అయితే Viewer, రాయడానికి Editor. Google గైడ్ ప్రకారం ఇది సాధారణ షేరింగ్ స్క్రీన్ ద్వారా జరుగుతుంది.
- కీని సర్వర్‌పై సీక్రెట్గా నిల్వ చేయండి, ఉదాహరణకు
GOOGLE_SERVICE_ACCOUNT_JSON, మరియు స్ప్రెడ్‌షీట్ IDని (షీట్ URLలోని పొడవైన స్ట్రింగ్)SHEET_IDగా. - మీ భాష కోసం Google క్లయింట్ లైబ్రరీతో సర్వర్ నుండి APIకి కాల్ చేయండి.
- రీడ్‌లను కాష్ చేయండి, అనేక సందర్శకులు ఒకే డేటాను చూస్తే, కోటాను తాకకుండా ఉండటానికి.
మీరు ఉపయోగించే కాల్స్
Google విలువలను చదవడం మరియు రాయడంపై గైడ్ నుండి:
| మెథడ్ | ఏమి చేస్తుంది |
|---|---|
spreadsheets.values.get | ఒక రేంజ్ చదువుతుంది, ఉదాహరణకు Leads!A1:E |
spreadsheets.values.batchGet | ఒకే రిక్వెస్ట్‌లో అనేక రేంజ్‌లను చదువుతుంది |
spreadsheets.values.update | నిర్దిష్ట రేంజ్‌కు రాస్తుంది |
spreadsheets.values.append | ఒక టేబుల్‌లో ఉన్న డేటా తర్వాత వరుసలు జోడిస్తుంది |
రేంజ్‌లు A1 నొటేషన్ ఉపయోగిస్తాయి. షీట్ పేరు లేకుండా A1:B2 వంటి రేంజ్ మొదటి షీట్‌కు వర్తిస్తుందని Google గమనిస్తుంది, కాబట్టి ఎవరైనా ట్యాబ్‌లను మార్చినప్పుడు ఆశ్చర్యాలు రాకుండా ట్యాబ్ పేరు స్పష్టంగా ఇవ్వండి.
RAW vs USER_ENTERED
రైట్‌లకు valueInputOption అవసరం:
- RAW మీరు పంపినదాన్ని ఖచ్చితంగా టెక్స్ట్‌గా నిల్వ చేస్తుంది.
=1+2టెక్స్ట్=1+2గా నిల్వ అవుతుంది. - USER_ENTERED ఇన్‌పుట్‌ను Sheetsలో టైప్ చేసినట్లు పరిగణిస్తుంది: తేదీలు తేదీలవుతాయి, మరియు
=1+2ఫార్ములా అవుతుంది.
మీ యాప్‌లో వినియోగదారు టైప్ చేసిన టెక్స్ట్ రాస్తే RAW వాడండి. USER_ENTEREDతో, ఎవరైనా ఫార్ములాను సమర్పించవచ్చు, అది సహోద్యోగి షీట్ తెరిచినప్పుడు రన్ అవుతుంది.
కోటాలు మరియు లోపాలు
సెప్టెంబర్ 2026 నాటికి, Google Sheets API పరిమితుల పేజీ జాబితా చేసేది:
| పరిమితి | రీడ్ రిక్వెస్ట్‌లు | రైట్ రిక్వెస్ట్‌లు |
|---|---|---|
| ప్రతి ప్రాజెక్ట్‌కు నిమిషానికి | 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 కీ GOOGLE_SERVICE_ACCOUNT_JSON సీక్రెట్‌లో ఉంది, మరియు స్ప్రెడ్‌షీట్ ID SHEET_IDలో ఉంది. Menu!A2:D రేంజ్ చదవండి (పేరు, వివరణ, ధర, వర్గం). ఫలితాన్ని 5 నిమిషాలు కాష్ చేయండి. API విఫలమైతే, చివరి కాష్ చేసిన వెర్షన్ చూపించండి. కీని ఎప్పుడూ బ్రౌజర్‌కు పంపవద్దు.
వరుసలు రాయడం:
ఎవరైనా కాంటాక్ట్ ఫారం సమర్పించినప్పుడు, దాన్ని మా డేటాబేస్‌లో సేవ్ చేయండి, మరియు "Leads" ట్యాబ్‌కు ఒక వరుస జోడించండి (తేదీ, పేరు, ఇమెయిల్, సందేశం) spreadsheets.values.append ఉపయోగించి valueInputOption RAW తో. Google 429 ఇస్తే, exponential backoffతో మళ్ళీ ప్రయత్నించండి; ఇంకా విఫలమైతే, లీడ్‌ను డేటాబేస్‌లో ఉంచి తర్వాత మళ్ళీ ప్రయత్నించండి.
సాధారణ తప్పులు
- service account ఇమెయిల్‌తో షీట్‌ను షేర్ చేయడం మర్చిపోవడం. కీ సరైనదైనా API అనుమతి లోపం ఇస్తుంది.
- కీని ఫ్రంటెండ్ లేదా రిపోజిటరీలో ఉంచడం. JSON కీ దానితో షేర్ చేసిన ప్రతి షీట్‌కు యాక్సెస్ ఇస్తుంది. API కీలను సురక్షితంగా ఎలా ఉంచాలి చూడండి.
- వినియోగదారు ఇన్‌పుట్ కోసం USER_ENTERED వాడటం, ఇది ఫార్ములా ఇంజెక్షన్‌ను అనుమతిస్తుంది.
- ప్రతి రిక్వెస్ట్‌లో APIకి కాల్ చేయడం, మొదటి ట్రాఫిక్ స్పైక్‌లోనే నిమిషపు కోటాను తాకడం.
- కాలమ్ స్థానాలపై ఆధారపడటం. ఎవరైనా కాలమ్ చొప్పిస్తే యాప్ తప్పు డేటా చదువుతుంది. హెడర్ వరుసను చదివి పేరు ద్వారా మ్యాప్ చేయండి, లేదా హెడర్‌ను లాక్ చేయండి.
- అవసరమైన దానికంటే ఎక్కువగా షీట్‌ను షేర్ చేయడం. "Anyone with the link" దాన్ని పబ్లిక్ చేస్తుంది.
- షీట్‌ను బహుళ-వినియోగదారుల డేటాబేస్‌గా వాడటం. ఏకకాల రైట్‌లు మరియు అనుమతులు లేకపోవడం డేటా పోవడానికి లేదా లీక్ కావడానికి కారణమవుతాయి.
చెక్‌లిస్ట్
- Sheets API ఎనేబుల్ చేయబడింది; service account సృష్టించబడింది
- అవసరమైన అత్యల్ప పాత్రతో షీట్ service account ఇమెయిల్‌తో షేర్ చేయబడింది
- కీ మరియు షీట్ ID సర్వర్-సైడ్ సీక్రెట్‌లుగా నిల్వ చేయబడ్డాయి
- అన్ని కాల్స్ సర్వర్ నుండి చేయబడ్డాయి
- రేంజ్‌లలో ట్యాబ్ పేర్లు ఉపయోగించబడ్డాయి
- వినియోగదారు అందించిన టెక్స్ట్ కోసం RAW ఉపయోగించబడింది
- రీడ్‌లు కాష్ చేయబడ్డాయి; 429 backoffతో నిర్వహించబడింది
- Sheets అందుబాటులో లేకపోతే యాప్ సున్నితంగా తగ్గిపోతుంది
- ఏ వైపు సత్య మూలమో నిర్ణయించబడింది
Mythexలో Google Sheets
Mythexలో Sheetsతో పని చేయడానికి రెండు వేర్వేరు మార్గాలు ఉన్నాయి. Connectors మీ Google ఖాతాను Mythexకు లింక్ చేస్తాయి, తద్వారా మీరు నిర్మిస్తున్నప్పుడు ఏజెంట్ దాన్ని ఉపయోగించగలదు, ఉదాహరణకు షీట్ చదివి దాని నుండి డాష్‌బోర్డ్ నిర్మించడం; డాక్స్ చెబుతాయి, క్రెడెన్షియల్ Mythex కనెక్షన్ సర్వీస్‌లోనే ఉంటుంది మరియు ఎప్పుడూ మీ కోడ్‌లోకి చేరదు (Connectors చూడండి, మరియు Google అడిగే ప్రతి అనుమతిని ఆమోదించండి). ప్రచురించిన యాప్ స్వయంగా షీట్‌ను చదవడానికి లేదా రాయడానికి, ఈ గైడ్‌లోని మార్గమే నమ్మదగినది: service account కీని ప్రాజెక్ట్ సీక్రెట్గా నిల్వ చేసి, మీ సర్వర్ నుండి Sheets API కాల్స్, Integrate any API లో ఉన్నట్లు. షీట్ సరిపోకపోతే, డేటాను ప్రాజెక్ట్ డేటాబేస్‌కు తరలించమని ఏజెంట్‌ను అడగండి, మరియు దాని పైన డాష్‌బోర్డ్ నిర్మించండి.
ప్రశ్నలు
నా యాప్ ప్రైవేట్ Google Sheetను ఎలా చదవగలదు?
సాధారణ మార్గం Google Cloud service account: Sheets APIని ఎనేబుల్ చేయండి, service account మరియు దాని కీని సృష్టించండి, తర్వాత స్ప్రెడ్‌షీట్‌ను service account ఇమెయిల్ చిరునామాతో Viewer లేదా Editorగా షేర్ చేయండి. మీ సర్వర్ సీక్రెట్గా నిల్వ చేసిన కీని ఉపయోగించి Sheets APIకి కాల్ చేస్తుంది.
స్ప్రెడ్‌షీట్‌ను యాక్సెస్ చేయడానికి Google API కీ వాడవచ్చా?
కేవలం పబ్లిక్ డేటా కోసం మాత్రమే. Google credentials గైడ్ ప్రకారం API కీలు పబ్లిక్‌గా అందుబాటులో ఉన్న డేటాకు అనామక యాక్సెస్ కోసం, ఉదాహరణకు లింక్ ఉన్న ఎవరికైనా షేర్ చేసిన ఫైళ్లకు. ప్రైవేట్ షీట్‌లకు service account లేదా OAuth అవసరం.
Google Sheets API పరిమితులు ఏమిటి?
సెప్టెంబర్ 2026 నాటికి, Google ప్రతి ప్రాజెక్ట్‌కు నిమిషానికి 300 రీడ్ మరియు 300 రైట్ రిక్వెస్ట్‌లు, మరియు ప్రతి వినియోగదారుకు ప్రతి ప్రాజెక్ట్‌కు నిమిషానికి 60 చొప్పున జాబితా చేస్తుంది, రోజువారీ పరిమితి లేదు. పరిమితి దాటితే 429 లోపం వస్తుంది; Google truncated exponential backoff సూచిస్తుంది.
Google Sheetsను నా యాప్ డేటాబేస్‌గా వాడాలా?
ప్రజలు షీట్‌లోనే డేటాను కూడా ఎడిట్ చేసే చిన్న, తక్కువ ట్రాఫిక్ యాప్‌లకు ఇది పనిచేస్తుంది. చాలా మంది వినియోగదారులు, తరచూ రైట్‌లు, రికార్డుల మధ్య సంబంధాలు, లేదా వినియోగదారుని బట్టి అనుమతులు ఉంటే, నిజమైన డేటాబేస్ మరింత నమ్మదగినది; అయినా డేటాను ఇంకా షీట్‌కు ఎగుమతి చేయవచ్చు.