Google Sheets നിങ്ങളുടെ ആപ്പുമായി എങ്ങനെ ബന്ധിപ്പിക്കാം
Google Sheets നിങ്ങളുടെ ആപ്പുമായി ബന്ധിപ്പിക്കാൻ, Google Cloud പ്രോജക്റ്റിൽ Google Sheets API ഓൺ ചെയ്യുക, ഒരു service account ഉണ്ടാക്കുക, സ്പ്രെഡ്ഷീറ്റ് service account-ന്റെ ഇമെയിൽ വിലാസവുമായി പങ്കിടുക, അതിന്റെ key ഒരു സെർവർ-സൈഡ് secret ആയി സൂക്ഷിക്കുക. പിന്നീട് നിങ്ങളുടെ സെർവർ spreadsheets.values.get ഉപയോഗിച്ച് വരികൾ വായിക്കുകയും spreadsheets.values.append ഉപയോഗിച്ച് പുതിയ വരികൾ ചേർക്കുകയും ചെയ്യും. ഉപയോക്താക്കൾക്ക് അവരവരുടെ ഷീറ്റുകൾ ബന്ധിപ്പിക്കണമെങ്കിൽ OAuth ഉപയോഗിക്കുക; ഷീറ്റ് പൂർണ്ണമായും പൊതുവാണെങ്കിൽ വായിക്കാൻ ലളിതമായ API key മതി.
ഈ ഗൈഡ് ഏത് രീതിയാണ് യോജിക്കുന്നതെന്നും, ആവശ്യമായ വിളികൾ, quota-കളും കെണികളും, AI ആപ്പ് ബിൽഡറിനുള്ള പ്രോംപ്റ്റുകൾ എന്നിവയും വിശദീകരിക്കുന്നു. Google-ന്റെ വിശദാംശങ്ങൾ 2026 സെപ്റ്റംബർ വരെയുള്ള Google-ന്റെ developer documentation അനുസരിച്ചുള്ളതാണ്.
ഷീറ്റ് ബന്ധിപ്പിക്കുന്നത് എന്തിന്?
സാധാരണ കാരണങ്ങൾ:
- ടീമിന്റെ വർക്ക്ഫ്ലോ നിലനിർത്തുക. സ്റ്റാഫ് ഒരു വില പട്ടികയോ ഷെഡ്യൂളോ Sheets-ൽ തന്നെ എഡിറ്റ് ചെയ്യുന്നത് തുടരുന്നു; ആപ്പ് അത് കാണിക്കുന്നു.
- ആളുകൾ ഇതിനകം നോക്കുന്നിടത്ത് ഡാറ്റ ശേഖരിക്കുക. പുതിയ സൈൻഅപ്പുകളും ഓർഡറുകളും ഫോം പ്രതികരണങ്ങളും വരികളായി എത്തുന്നു.
- റിപ്പോർട്ടിംഗ്. സ്പ്രെഡ്ഷീറ്റിൽ ജോലി ചെയ്യുന്നവർക്കായി ആപ്പ് ഡാറ്റ ഷീറ്റിലേക്ക് എക്സ്പോർട്ട് ചെയ്യുക.
- ഒരു ആദ്യ ചുവടുവെപ്പ്. ഷീറ്റിൽ നിന്ന് തുടങ്ങി, പിന്നീട് ശരിയായ ഡാറ്റാബേസിലേക്ക് മാറുക. ഒരു സ്പ്രെഡ്ഷീറ്റ് ആപ്പാക്കി മാറ്റുന്നത് എങ്ങനെ എന്ന് കാണുക.
നിങ്ങളുടെ ആപ്പ് Google-ൽ സൈൻ ഇൻ ചെയ്യുന്ന രീതി തിരഞ്ഞെടുക്കുക
Google-ന്റെ credentials ഗൈഡ് മൂന്ന് തരങ്ങൾ വിവരിക്കുന്നു:
| Credential | ആക്സസ് ചെയ്യാവുന്നത് | ഏറ്റവും അനുയോജ്യം |
|---|---|---|
| API key | “ലിങ്കുള്ള ആർക്കും” പങ്കിട്ട ഫയലുകൾ പോലുള്ള പൊതു ഡാറ്റ മാത്രം | പൊതു ഷീറ്റ് വായിക്കുന്നത് |
| 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 ആയും. സാധാരണ Sharing സ്ക്രീനിലൂടെയാണ് ഇത് ചെയ്യുന്നതെന്ന് Google-ന്റെ ഗൈഡ് പറയുന്നു.
- Key ഒരു secret ആയി സെർവറിൽ സൂക്ഷിക്കുക, ഉദാഹരണത്തിന്
GOOGLE_SERVICE_ACCOUNT_JSON, കൂടാതെ സ്പ്രെഡ്ഷീറ്റ് ID (ഷീറ്റിന്റെ URL-ലെ നീണ്ട സ്ട്രിംഗ്)SHEET_IDആയും. - സെർവറിൽ നിന്ന് API വിളിക്കുക, നിങ്ങളുടെ ഭാഷയ്ക്കുള്ള Google-ന്റെ client library ഉപയോഗിച്ച്.
- വായനകൾ cache ചെയ്യുക, ഒരേ ഡാറ്റ പലരും കാണുന്നുണ്ടെങ്കിൽ. അങ്ങനെ quota എത്തുന്നത് ഒഴിവാക്കാം.
നിങ്ങൾ ഉപയോഗിക്കുന്ന വിളികൾ
Google-ന്റെ values വായിക്കലും എഴുതലും സംബന്ധിച്ച ഗൈഡിൽ നിന്ന്:
| Method | ചെയ്യുന്നത് |
|---|---|
spreadsheets.values.get | ഒരു range വായിക്കുന്നു, ഉദാഹരണത്തിന് Leads!A1:E |
spreadsheets.values.batchGet | ഒരു request-ൽ പല range-കൾ വായിക്കുന്നു |
spreadsheets.values.update | ഒരു പ്രത്യേക range-ൽ എഴുതുന്നു |
spreadsheets.values.append | ഒരു table-ലെ നിലവിലുള്ള ഡാറ്റയ്ക്ക് ശേഷം വരികൾ ചേർക്കുന്നു |
Range-കൾ A1 notation ഉപയോഗിക്കുന്നു. A1:B2 പോലെ ഷീറ്റിന്റെ പേരില്ലാത്ത range ആദ്യ ഷീറ്റിനാണ് ബാധകമാകുന്നതെന്ന് Google പറയുന്നു; ആരെങ്കിലും ടാബുകളുടെ ക്രമം മാറ്റിയാൽ അത്ഭുതങ്ങൾ ഒഴിവാക്കാൻ ടാബിന്റെ പേര് വ്യക്തമായി നൽകുക.
RAW vs USER_ENTERED
എഴുതുമ്പോൾ valueInputOption വേണം:
- RAW നിങ്ങൾ അയക്കുന്നത് അതേപടി ടെക്സ്റ്റായി സൂക്ഷിക്കുന്നു.
=1+2എന്നത് ടെക്സ്റ്റായ=1+2ആയി സൂക്ഷിക്കപ്പെടുന്നു. - USER_ENTERED ഇൻപുട്ട് Sheets-ൽ നേരിട്ട് ടൈപ്പ് ചെയ്തതുപോലെ പരിഗണിക്കുന്നു: തീയതികൾ തീയതികളാകുന്നു,
=1+2ഒരു ഫോർമുലയാകുന്നു.
ഉപയോക്താക്കൾ നിങ്ങളുടെ ആപ്പിൽ ടൈപ്പ് ചെയ്ത ടെക്സ്റ്റ് എഴുതുകയാണെങ്കിൽ RAW ഉപയോഗിക്കുക. USER_ENTERED ആണെങ്കിൽ, ആരെങ്കിലും സമർപ്പിക്കുന്ന ഒരു ഫോർമുല, സഹപ്രവർത്തകൻ ഷീറ്റ് തുറക്കുമ്പോൾ പ്രവർത്തിച്ചേക്കാം.
Quota-കളും പിശകുകളും
2026 സെപ്റ്റംബർ പ്രകാരം, Google-ന്റെ Sheets API പരിധി പേജ് പറയുന്നത്:
| പരിധി | Read request | Write request |
|---|---|---|
| ഒരു പ്രോജക്റ്റിന് മിനിറ്റിൽ | 300 | 300 |
| ഒരു ഉപയോക്താവിന് പ്രോജക്റ്റിൽ മിനിറ്റിൽ | 60 | 60 |
മിനിറ്റ് പരിധികൾക്കുള്ളിൽ നിൽക്കുന്നിടത്തോളം ദിവസ പരിധിയില്ല. പരിധി കവിഞ്ഞാൽ 429: Too many requests ലഭിക്കും, Google truncated exponential backoff ശുപാർശ ചെയ്യുന്നു: ഓരോ തവണ പരാജയപ്പെടുമ്പോഴും കൂടുതൽ സമയം കാത്തിരിക്കുക, ക്രമരഹിതമായ ഒരു കാലതാമസം ചേർത്ത്, ഒരു പരമാവധി വരെ. ഒരൊറ്റ request 180 സെക്കൻഡിൽ കൂടുതലെടുത്താൽ timeout ആകും.
പ്രായോഗികമായി: ഓരോ page view-നും API വിളിക്കരുത്. ഷീറ്റ് ഡാറ്റ ഒരു മിനിറ്റോ അതിൽ കൂടുതലോ cache ചെയ്യുക, വായനകൾ batchGet ഉപയോഗിച്ച് ഒന്നിച്ചാക്കുക, കഴിയുന്നിടത്ത് എഴുത്തുകളും ഒന്നിച്ചാക്കുക.
ഓപ്ഷനുകളും ട്രേഡ്-ഓഫുകളും
| സമീപനം | ഗുണങ്ങൾ | ദോഷങ്ങൾ |
|---|---|---|
| ഷീറ്റ് തത്സമയ ഡാറ്റ ഉറവിടമായി | സ്റ്റാഫിന് പരിചിതമായ ടൂൾ; അഡ്മിൻ സ്ക്രീനുകൾ നിർമ്മിക്കേണ്ടതില്ല | Quota, വരി തിരിച്ചുള്ള അനുമതികളില്ല, ഒരു കോളം പേര് മാറ്റിയാൽ എളുപ്പം തകരും |
| ഷീറ്റ് ഡാറ്റാബേസിലേക്ക് സിങ്ക് ചെയ്യുക | വേഗത്തിലും വിശ്വസനീയമായും വായിക്കാം; Sheets ഡൗൺ ആയാലും ആപ്പ് പ്രവർത്തിക്കും | ഒരു sync job വേണം, ഏത് വശമാണ് ജയിക്കുക എന്നതിന് ഒരു നിയമവും വേണം |
| ആദ്യം ഡാറ്റാബേസ്, പിന്നെ ഷീറ്റിലേക്ക് എക്സ്പോർട്ട് | ഡാറ്റ ആപ്പിന്റേതാണ്; ഷീറ്റ് ഒരു റിപ്പോർട്ട് മാത്രം | ഷീറ്റിലെ എഡിറ്റുകൾ തിരികെ ഒഴുകില്ല |
| മധ്യത്തിൽ ഒരു ഓട്ടോമേഷൻ ടൂൾ | ലളിതമായ ഫ്ലോകൾക്ക് കോഡ് വേണ്ട | മറ്റൊരു സബ്സ്ക്രിപ്ഷൻ; ഡീബഗ് ചെയ്യാൻ പ്രയാസം |
ധാരാളം ഉപയോക്താക്കളോ സെൻസിറ്റീവ് ഡാറ്റയോ ഉള്ള ഏതിനും, ഡാറ്റാബേസാണ് മികച്ച സത്യത്തിന്റെ ഉറവിടം. ഡാറ്റാബേസ് എന്താണെന്ന് കാണുക.
നിങ്ങളുടെ AI ബിൽഡറിനുള്ള പ്രോംപ്റ്റുകൾ
ഒരു ഷീറ്റ് വായിക്കാൻ:
ഞങ്ങളുടെ Google Sheet-ലെ “Menu” ടാബ് മെനു പേജിൽ കാണിക്കുക. സെർവറിൽ നിന്ന് Google Sheets API ഉപയോഗിക്കുക, service account-ന്റെ JSON key
GOOGLE_SERVICE_ACCOUNT_JSONഎന്ന secret-ലും spreadsheet IDSHEET_ID-ലും.Menu!A2:Drange വായിക്കുക (പേര്, വിവരണം, വില, വിഭാഗം). ഫലം 5 മിനിറ്റ് cache ചെയ്യുക. API പരാജയപ്പെട്ടാൽ അവസാനം cache ചെയ്ത പതിപ്പ് കാണിക്കുക. Key ഒരിക്കലും ബ്രൗസറിലേക്ക് അയക്കരുത്.
വരികൾ എഴുതാൻ:
ആരെങ്കിലും കോൺടാക്റ്റ് ഫോം സമർപ്പിക്കുമ്പോൾ അത് ഞങ്ങളുടെ ഡാറ്റാബേസിൽ സേവ് ചെയ്യുക, കൂടാതെ “Leads” ടാബിൽ ഒരു വരി ചേർക്കുക (തീയതി, പേര്, ഇമെയിൽ, സന്ദേശം)
valueInputOptionRAW ആയിspreadsheets.values.appendഉപയോഗിച്ച്. Google 429 നൽകിയാൽ exponential backoff ഉപയോഗിച്ച് വീണ്ടും ശ്രമിക്കുക; എന്നിട്ടും പരാജയപ്പെട്ടാൽ ലീഡ് ഡാറ്റാബേസിൽ സൂക്ഷിച്ച് പിന്നീട് വീണ്ടും ശ്രമിക്കുക.
സാധാരണ തെറ്റുകൾ
- Service account-ന് ഷീറ്റ് പങ്കിടാൻ മറക്കുന്നത്. Key ശരിയാണെങ്കിലും API ഒരു അനുമതി പിശക് നൽകും.
- Key ഫ്രണ്ട്എൻഡിലോ റിപ്പോസിറ്ററിയിലോ. JSON key അതുമായി പങ്കിട്ട എല്ലാ ഷീറ്റുകളിലേക്കും ആക്സസ് നൽകുന്നു. API key-കൾ സുരക്ഷിതമായി സൂക്ഷിക്കുന്നത് എങ്ങനെ കാണുക.
- ഉപയോക്താവ് നൽകുന്ന ടെക്സ്റ്റിന് USER_ENTERED ഉപയോഗിക്കുന്നത്, ഇത് ഫോർമുല ഇൻജക്ഷന് വഴിയൊരുക്കുന്നു.
- ഓരോ request-ലും API വിളിക്കുന്നത്, ആദ്യത്തെ ട്രാഫിക് സ്പൈക്കിൽ തന്നെ മിനിറ്റ് quota എത്തുന്നു.
- കോളം സ്ഥാനങ്ങളെ ആശ്രയിക്കുന്നത്. ആരെങ്കിലും ഒരു കോളം ചേർത്താൽ ആപ്പ് തെറ്റായ ഡാറ്റ വായിക്കും. Header വരി വായിച്ച് പേര് വെച്ച് മാപ്പ് ചെയ്യുക, അല്ലെങ്കിൽ header ലോക്ക് ചെയ്യുക.
- ആവശ്യത്തിലധികം വിശാലമായി ഷീറ്റ് പങ്കിടുന്നത്. “ലിങ്കുള്ള ആർക്കും” എന്നത് അതിനെ പൊതുവാക്കുന്നു.
- ഒന്നിലധികം ഉപയോക്താക്കളുടെ ഡാറ്റാബേസായി ഒരു ഷീറ്റ് ഉപയോഗിക്കുന്നത്. ഒരേസമയത്തെ എഴുത്തുകളും നഷ്ടപ്പെട്ട അനുമതികളും ഡാറ്റ നഷ്ടപ്പെടാനോ ചോരാനോ ഇടയാക്കുന്നു.
ചെക്ക്ലിസ്റ്റ്
- Sheets API ഓൺ ആക്കി; service account ഉണ്ടാക്കി
- ഷീറ്റ് service account ഇമെയിലുമായി, വേണ്ട ഏറ്റവും കുറഞ്ഞ റോളിൽ പങ്കിട്ടു
- Key-യും ഷീറ്റ് ID-യും സെർവർ-സൈഡ് secret-കളായി സൂക്ഷിച്ചു
- എല്ലാ വിളികളും സെർവറിൽ നിന്ന്
- Range-കളിൽ ടാബിന്റെ പേര് ഉപയോഗിക്കുന്നു
- ഉപയോക്താവ് നൽകുന്ന ടെക്സ്റ്റിന് RAW ഉപയോഗിക്കുന്നു
- വായനകൾ cache ചെയ്തു; 429 backoff ഉപയോഗിച്ച് കൈകാര്യം ചെയ്യുന്നു
- Sheets ലഭ്യമല്ലാത്തപ്പോഴും ആപ്പ് സുഗമമായി പ്രവർത്തിക്കുന്നു
- ഏത് വശമാണ് സത്യത്തിന്റെ ഉറവിടം എന്ന് തീരുമാനിച്ചു
Mythex-ൽ Google Sheets
Mythex-ൽ Sheets-മായി പ്രവർത്തിക്കാൻ രണ്ട് വ്യത്യസ്ത വഴികളുണ്ട്. Connectors നിങ്ങളുടെ Google അക്കൗണ്ട് Mythex-മായി ബന്ധിപ്പിക്കുന്നു, അതുവഴി നിർമ്മാണ സമയത്ത് ഏജന്റിന് അത് ഉപയോഗിക്കാം; ഉദാഹരണത്തിന് ഒരു ഷീറ്റ് വായിച്ച് അതിൽ നിന്ന് ഡാഷ്ബോർഡ് ഉണ്ടാക്കാം. ഡോക്സ് പറയുന്നത്, ക്രെഡൻഷ്യൽ Mythex-ന്റെ കണക്ഷൻ സർവീസിൽ തന്നെ നിൽക്കുന്നു, ഒരിക്കലും നിങ്ങളുടെ കോഡിൽ എത്തുന്നില്ല എന്നാണ് (മുഴുവൻ വിവരങ്ങൾക്ക് Connectors കാണുക; Google ചോദിക്കുന്ന ഓരോ അനുമതിയും ശ്രദ്ധയോടെ അംഗീകരിക്കുക). പ്രസിദ്ധീകരിച്ച ആപ്പിന് സ്വന്തമായി ഒരു ഷീറ്റ് വായിക്കാനോ എഴുതാനോ, ഈ ഗൈഡിലെ വഴിയാണ് വിശ്വസനീയം: service account key ഒരു പ്രോജക്റ്റ് secret ആയി സൂക്ഷിക്കുക, സെർവറിൽ നിന്ന് Sheets API വിളിക്കുക; ഇത് Integrate any API-ലും വിവരിച്ചിരിക്കുന്നു. ഷീറ്റിനെ മറികടക്കുകയാണെങ്കിൽ, ഡാറ്റ പ്രോജക്റ്റിന്റെ ഡാറ്റാബേസിലേക്ക് മാറ്റാൻ ഏജന്റിനോട് ആവശ്യപ്പെടുകയും അതിന് മുകളിൽ ഒരു ഡാഷ്ബോർഡ് നിർമ്മിക്കുകയും ചെയ്യുക.
ചോദ്യങ്ങൾ
എനിക്ക് സ്വകാര്യ Google Sheet ആപ്പിന് വായിക്കാൻ കഴിയുമോ?
സാധാരണ വഴി Google Cloud service account ആണ്: Sheets API ഓൺ ചെയ്യുക, service account-ഉം അതിന്റെ key-യും ഉണ്ടാക്കുക, തുടർന്ന് സ്പ്രെഡ്ഷീറ്റ് service account-ന്റെ ഇമെയിൽ വിലാസവുമായി Viewer അല്ലെങ്കിൽ Editor ആയി പങ്കിടുക. നിങ്ങളുടെ സെർവർ, secret ആയി സൂക്ഷിച്ച key ഉപയോഗിച്ച് Sheets API വിളിക്കുന്നു.
Google API key ഉപയോഗിച്ച് ഒരു സ്പ്രെഡ്ഷീറ്റ് ആക്സസ് ചെയ്യാമോ?
പൊതു ഡാറ്റയ്ക്ക് മാത്രം. API key പൊതുവായി ലഭ്യമായ ഡാറ്റയ്ക്ക് അജ്ഞാത ആക്സസിനാണ് ഉപയോഗിക്കേണ്ടതെന്ന് Google-ന്റെ credentials ഗൈഡ് പറയുന്നു; ഉദാഹരണത്തിന് “ലിങ്കുള്ള ആർക്കും” പങ്കിട്ട ഫയലുകൾ. സ്വകാര്യ ഷീറ്റുകൾക്ക് service account അല്ലെങ്കിൽ OAuth വേണം.
Google Sheets API-യുടെ പരിധികൾ എന്തൊക്കെയാണ്?
2026 സെപ്റ്റംബർ പ്രകാരം, Google ഒരു പ്രോജക്റ്റിന് മിനിറ്റിൽ 300 read, 300 write request എന്നും, ഓരോ ഉപയോക്താവിനും പ്രോജക്റ്റിന് മിനിറ്റിൽ 60 വീതം എന്നും പട്ടികപ്പെടുത്തുന്നു. ദിവസ പരിധിയില്ല. പരിധി കവിഞ്ഞാൽ 429 പിശക് ലഭിക്കും; Google truncated exponential backoff ശുപാർശ ചെയ്യുന്നു.
എന്റെ ആപ്പിന്റെ ഡാറ്റാബേസായി Google Sheets ഉപയോഗിക്കണോ?
ചെറിയ, കുറഞ്ഞ ട്രാഫിക്കുള്ള ആപ്പുകൾക്ക്, ആളുകൾ ഷീറ്റിലെ ഡാറ്റ നേരിട്ട് എഡിറ്റ് ചെയ്യുന്ന സാഹചര്യങ്ങളിൽ ഇത് പ്രവർത്തിക്കും. ധാരാളം ഉപയോക്താക്കൾ, പതിവ് എഴുത്തുകൾ, റെക്കോർഡുകൾ തമ്മിലുള്ള ബന്ധങ്ങൾ, ഓരോ ഉപയോക്താവിനുമുള്ള അനുമതികൾ എന്നിവ വേണ്ടിവരുമ്പോൾ യഥാർത്ഥ ഡാറ്റാബേസ് കൂടുതൽ വിശ്വസനീയമാണ്. ഷീറ്റിലേക്ക് എക്സ്പോർട്ട് ചെയ്യുന്നത് അപ്പോഴും സാധ്യമാണ്.