உங்கள் ஆப்புடன் Google Sheets-ஐ எப்படி இணைப்பது

உங்கள் ஆப்புடன் Google Sheets-ஐ இணைக்க, Google Cloud திட்டத்தில் Google Sheets API-ஐ இயக்குங்கள், ஒரு service account-ஐ உருவாக்குங்கள், spreadsheet-ஐ service account-ன் மின்னஞ்சல் முகவரியுடன் பகிருங்கள், அதன் key-ஐ ஒரு சர்வர் பக்க secret ஆக சேமியுங்கள். பின்னர் உங்கள் சர்வர் spreadsheets.values.get மூலம் வரிசைகளைப் படித்து, spreadsheets.values.append மூலம் வரிசைகளைச் சேர்க்கிறது. பயனர்கள் தங்கள் சொந்த sheet-களை இணைக்க வேண்டுமென்றால் OAuth பயன்படுத்துங்கள்; sheet முழுவதும் பொதுவாக இருந்தால், படிப்பதற்கு ஒரு எளிய API key போதும்.

இந்த வழிகாட்டி எந்த முறை பொருந்துகிறது, உங்களுக்குத் தேவையான அழைப்புகள், quota-கள் மற்றும் பொறிகள், AI ஆப் பில்டருக்கான prompt-கள் ஆகியவற்றை உள்ளடக்குகிறது. Google விவரங்கள் செப்டம்பர் 2026 நிலவரப்படி Google-ன் developer ஆவணங்களிலிருந்து.

ஒரு sheet-ஐ இணைப்பதற்கான காரணங்கள்

பொதுவான காரணங்கள்:

• குழுவின் பணிமுறையைத் தக்கவைப்பது. ஊழியர்கள் ஏற்கனவே Sheets-ல் விலைப்பட்டியல் அல்லது அட்டவணையைத் திருத்துகிறார்கள்; ஆப் அதைக் காட்டுகிறது.
• மக்கள் ஏற்கனவே பார்க்கும் இடத்தில் தரவைச் சேகரிப்பது. புதிய பதிவுகள், ஆர்டர்கள் அல்லது படிவப் பதில்கள் வரிசைகளாக வந்து சேரும்.
• அறிக்கையிடல். ஆப் தரவை விரிதாள்களில் வாழ்பவர்களுக்காக ஒரு sheet-க்கு ஏற்றுமதி செய்வது.
• ஒரு படிக்கல். Sheet-லிருந்து தொடங்கி பின்னர் ஒரு சரியான database-க்கு நகருங்கள். விரிதாளை ஆப்பாக மாற்றுவது எப்படி பாருங்கள்.

உங்கள் ஆப் Google-க்கு எப்படி உள்நுழைகிறது என்று தேர்ந்தெடுங்கள்

Google-ன் credentials வழிகாட்டி மூன்று வகைகளை விவரிக்கிறது:

பெரும்பாலான ஆப்புகளுக்கு service account சரியான தேர்வு: நீங்கள் வைத்திருக்கும் ஒரு credentials தொகுப்பு, நீங்கள் வெளிப்படையாகப் பகிரும் sheet-களுக்கு மட்டும் அணுகல்.

Service account மூலம் படிப்படியாக

1. ஒரு Google Cloud திட்டத்தை உருவாக்குங்கள் அல்லது தேர்ந்தெடுங்கள் மற்றும் Google Sheets API-ஐ இயக்குங்கள்.
2. Service account-ஐ அதற்கான key-யுடன் உருவாக்குங்கள். Key ஒரு JSON கோப்பு; அதை கடவுச்சொல் போல நடத்துங்கள்.
3. Spreadsheet-ஐப் பகிருங்கள் service account-ன் மின்னஞ்சல் முகவரியுடன், படிக்க மட்டும் என்றால் Viewer, எழுத Editor ஆக. Google-ன் வழிகாட்டி இது சாதாரண பகிர்வுத் திரை மூலம் செய்யப்படுகிறது என்கிறது.
4. Key-ஐ உங்கள் சர்வரில் secret ஆக சேமியுங்கள், எ.கா. GOOGLE_SERVICE_ACCOUNT_JSON, மற்றும் spreadsheet ID-ஐ (sheet-ன் URL-ல் உள்ள நீண்ட சரம்) SHEET_ID ஆக.
5. உங்கள் சர்வரிலிருந்து API-ஐ அழையுங்கள், உங்கள் மொழிக்கான Google client library மூலம்.
6. வாசிப்புகளை cache செய்யுங்கள், பல பார்வையாளர்கள் ஒரே தரவைக் கண்டால், quota-ஐ அடையாமல் இருக்க.

நீங்கள் பயன்படுத்தப் போகும் அழைப்புகள்

Google-ன் மதிப்புகளைப் படித்து எழுதும் வழிகாட்டியிலிருந்து:

வரம்புகள் A1 குறியீட்டு முறையைப் பயன்படுத்துகின்றன. A1:B2 போன்ற sheet பெயர் இல்லாத வரம்பு முதல் sheet-க்குப் பொருந்தும் என்று Google குறிப்பிடுகிறது; எனவே யாராவது தாள்களை மறுவரிசைப்படுத்தும்போது ஆச்சரியங்களைத் தவிர்க்க, தாள் பெயரை வெளிப்படையாகக் குறியிடுங்கள்.

RAW எதிர் USER_ENTERED

எழுதுதலுக்கு valueInputOption தேவை:

• RAW நீங்கள் அனுப்புவதையே உரையாகச் சேமிக்கும். =1+2 உரை =1+2 ஆகச் சேமிக்கப்படும்.
• USER_ENTERED உள்ளீட்டை Sheets-ல் தட்டச்சு செய்ததுபோல நடத்தும்: தேதிகள் தேதிகளாகும், =1+2 ஒரு பார்முலா ஆகும்.

உங்கள் ஆப்பில் பயனர் தட்டச்சு செய்த உரையை எழுதினால், RAW பயன்படுத்துங்கள். USER_ENTERED-ல், ஒருவர் ஒரு பார்முலாவைச் சமர்ப்பிக்கலாம், அது சக ஊழியர் sheet-ஐத் திறக்கும்போது இயங்கும்.

Quota-கள் மற்றும் பிழைகள்

செப்டம்பர் 2026 நிலவரப்படி, Google-ன் Sheets API வரம்புகள் பக்கம் பட்டியலிடுவது:

நிமிட quota-களுக்குள் இருக்கும் வரை தினசரி வரம்பு இல்லை. மீறினால் 429: Too many requests வரும், மேலும் Google truncated exponential backoff பரிந்துரைக்கிறது: ஒவ்வொரு தோல்வியுற்ற முயற்சிக்குப் பின்னும் நீண்ட நேரம் காத்திருங்கள், ஒரு சீரற்ற தாமதத்துடன், அதிகபட்சம் வரை. 180 வினாடிகளுக்கு மேல் எடுக்கும் ஒரு கோரிக்கை timeout ஆகும்.

நடைமுறையில்: ஒவ்வொரு பக்கப் பார்வைக்கும் API-ஐ அழைக்காதீர்கள். Sheet தரவை ஒரு நிமிடத்துக்கு மேல் cache செய்யுங்கள், batchGet மூலம் வாசிப்புகளை ஒருங்கிணையுங்கள், முடிந்தால் எழுதுதல்களையும் ஒருங்கிணையுங்கள்.

விருப்பங்களும் பரிமாற்றங்களும்

அதிக பயனர்கள் அல்லது உணர்திறன் தரவு உள்ள எதற்கும், database சிறந்த உண்மை மூலம். database என்றால் என்ன பாருங்கள்.

உங்கள் AI பில்டருக்கான prompt-கள்

Sheet-ஐப் படிக்க:

எங்கள் Google Sheet-ன் "Menu" தாவலை menu பக்கத்தில் காட்டுங்கள். சர்வரிலிருந்து Google Sheets API-ஐப் பயன்படுத்துங்கள், GOOGLE_SERVICE_ACCOUNT_JSON என்ற secret-ல் உள்ள service account JSON key-உடன், SHEET_ID-ல் spreadsheet ID-உடன். Menu!A2:D வரம்பைப் படியுங்கள் (பெயர், விளக்கம், விலை, வகை). முடிவை 5 நிமிடங்களுக்கு cache செய்யுங்கள். API தோல்வியடைந்தால், கடைசியாக cache செய்த பதிப்பைக் காட்டுங்கள். Key-ஐ ஒருபோதும் உலாவிக்கு அனுப்பாதீர்கள்.

வரிசைகளை எழுத:

யாராவது தொடர்பு படிவத்தைச் சமர்ப்பித்தால், அதை எங்கள் database-ல் சேமியுங்கள், அத்துடன் "Leads" தாவலில் ஒரு வரிசையைச் சேருங்கள் (தேதி, பெயர், மின்னஞ்சல், செய்தி), valueInputOption RAW உடன் spreadsheets.values.append பயன்படுத்தி. Google 429 தந்தால், exponential backoff உடன் மீண்டும் முயலுங்கள்; இன்னும் தோல்வியுற்றால், லீடை database-ல் வைத்திருங்கள், பின்னர் மீண்டும் முயலுங்கள்.

பொதுவான தவறுகள்

• Sheet-ஐ service account மின்னஞ்சலுடன் பகிர மறப்பது. key சரியாக இருந்தாலும் API அனுமதிப் பிழை தரும்.
• Key ஃப்ரன்ட்எண்டிலோ repository-லோ இருப்பது. JSON key பகிரப்பட்ட ஒவ்வொரு sheet-ஐயும் அணுகும். API key-களை எப்படிப் பாதுகாப்பாக வைப்பது பாருங்கள்.
• பயனர் உள்ளீட்டுக்கு USER_ENTERED பயன்படுத்துவது, இது பார்முலா உட்செலுத்தலை அனுமதிக்கும்.
• ஒவ்வொரு கோரிக்கையிலும் API-ஐ அழைப்பது, முதல் போக்குவரத்து உச்சத்திலேயே நிமிட quota-ஐ அடைவது.
• நெடுவரிசை நிலைகளைச் சார்ந்திருப்பது. யாராவது ஒரு நெடுவரிசையைச் செருகினால், ஆப் தவறான தரவைப் படிக்கும். தலைப்பு வரிசையைப் படித்து பெயரின் அடிப்படையில் வரைபடமாக்குங்கள், அல்லது தலைப்பைப் பூட்டுங்கள்.
• தேவைக்கு மேல் sheet-ஐ பரவலாகப் பகிர்வது. "இணைப்பு உள்ள அனைவரும்" அதைப் பொதுவாக்கும்.
• பல பயனர் database ஆக sheet-ஐப் பயன்படுத்துவது. ஒரே நேர எழுதுதல்களும் விடுபட்ட அனுமதிகளும் தரவு இழப்பு அல்லது கசிவை ஏற்படுத்தும்.

சரிபார்ப்புப் பட்டியல்

• Sheets API இயக்கப்பட்டது; service account உருவாக்கப்பட்டது
• Sheet தேவையான மிகக் குறைந்த பங்கில் service account மின்னஞ்சலுடன் பகிரப்பட்டது
• Key மற்றும் sheet ID சர்வர் பக்க secret-களாகச் சேமிக்கப்பட்டன
• எல்லா அழைப்புகளும் சர்வரிலிருந்து செய்யப்படுகின்றன
• வரம்புகளில் தாவல் பெயர்கள் பயன்படுத்தப்பட்டுள்ளன
• பயனர் வழங்கிய உரைக்கு RAW பயன்படுத்தப்படுகிறது
• வாசிப்புகள் cache செய்யப்பட்டுள்ளன; 429 backoff உடன் கையாளப்படுகிறது
• Sheets கிடைக்காதபோது ஆப் சீராகக் குறைந்த அம்சங்களுடன் இயங்குகிறது
• எது உண்மை மூலம் என்று முடிவு செய்யப்பட்டுள்ளது

Mythex-ல் Google Sheets

Mythex-ல் Sheets-உடன் வேலை செய்ய இரண்டு வெவ்வேறு வழிகள் உள்ளன. Connectors உங்கள் Google கணக்கை Mythex-உடன் இணைக்கும், அதனால் நீங்கள் உருவாக்கும்போது ஏஜென்ட் அதைப் பயன்படுத்த முடியும், எ.கா. ஒரு டாஷ்போர்டு உருவாக்க sheet-ஐப் படிப்பது; docs சொல்வது, அந்தச் சான்று Mythex-ன் இணைப்பு சேவையிலேயே இருக்கும், உங்கள் குறியீட்டுக்குள் ஒருபோதும் போகாது (பார்க்க Connectors, Google கேட்கும் ஒவ்வொரு அனுமதியையும் அங்கீகரியுங்கள்). வெளியிடப்பட்ட ஆப் தானாகவே sheet-ஐப் படிக்கவோ எழுதவோ வேண்டுமென்றால், இந்த வழிகாட்டியில் உள்ள வழிதான் நம்பகமானது: project secret-ஆக சேமிக்கப்பட்ட service account key, மற்றும் உங்கள் சர்வரிலிருந்து Sheets API அழைப்புகள், Integrate any API என்பதில் உள்ளபடி. Sheet-ஐ நீங்கள் மிஞ்சுகிறீர்கள் என்றால், தரவை திட்டத்தின் database-க்கு நகர்த்தி அதன் மேல் ஒரு டாஷ்போர்டு உருவாக்கும்படி ஏஜென்டிடம் கேளுங்கள்.

கேள்விகள்