Si të lidhni Google Sheets me aplikacionin tuaj

Për të lidhur Google Sheets me aplikacionin tuaj, aktivizoni Google Sheets API në një projekt Google Cloud, krijoni një llogari shërbimi, ndajeni fletëllogaritësin me adresën email të llogarisë së shërbimit, dhe ruajeni çelësin e saj si sekret në server. Serveri juaj më pas lexon rreshta me spreadsheets.values.get dhe shton rreshta me spreadsheets.values.append. Nëse përdoruesit duhet të lidhin fletëllogaritësit e tyre, përdorni OAuth në vend të kësaj, dhe nëse sheet-i është krejt publik, një çelës API i thjeshtë mjafton për leximin.

Ky udhëzues mbulon cila metodë i përshtatet, thirrjet që ju duhen, kuotat dhe kurthet, dhe kërkesat për një ndërtues aplikacionesh me AI. Detajet e Google janë nga dokumentacioni i zhvilluesve të Google, që nga shtatori 2026.

Pse të lidhni një sheet fare

Arsye të zakonshme:

• Ruani rrjedhën e punës së ekipit. Stafi vazhdon të redaktojë një listë çmimesh ose orar në Sheets; aplikacioni e shfaq.
• Mblidhni të dhëna aty ku njerëzit tashmë shikojnë. Regjistrimet e reja, porositë ose përgjigjet e formularëve bëhen rreshta.
• Raportim. Eksportoni të dhënat e aplikacionit në një sheet për njerëzit që punojnë me fletëllogaritës.
• Një hap i ndërmjetëm. Filloni nga sheet-i, pastaj kaloni te një bazë e duhur të dhënash. Shihni si ta kthejmë një fletëllogaritës në aplikacion.

Zgjidhni si hyn aplikacioni juaj në Google

Udhëzuesi i kredencialeve të Google përshkruan tre lloje:

Për shumicën e aplikacioneve, llogaria e shërbimit është zgjedhja e duhur: një grup kredencialesh, i zotëruar nga ju, me akses vetëm te sheet-et që ndani me të në mënyrë të qartë.

Hap pas hapi me një llogari shërbimi

1. Krijoni ose zgjidhni një projekt Google Cloud dhe aktivizoni Google Sheets API.
2. Krijoni një llogari shërbimi dhe një çelës për të. Çelësi është një skedar JSON; trajtojeni si fjalëkalim.
3. Ndajeni fletëllogaritësin me adresën email të llogarisë së shërbimit, si Viewer për lexim të vetëm ose Editor për shkrim. Udhëzuesi i Google thotë se kjo bëhet përmes ekranit normal të ndarjes.
4. Ruajeni çelësin si sekret në serverin tuaj, për shembull GOOGLE_SERVICE_ACCOUNT_JSON, plus ID-në e fletëllogaritësit (vargu i gjatë në URL-në e sheet-it) si SHEET_ID.
5. Thirrni API-n nga serveri me bibliotekën klient të Google për gjuhën tuaj.
6. Ruani në cache leximet nëse shumë vizitorë shohin të njëjtat të dhëna, që të mos e arrini kuotën.

Thirrjet që do të përdorni

Nga udhëzuesi i Google për leximin dhe shkrimin e vlerave:

Diapazonet përdorin shënimin A1. Google thotë se një diapazon pa emër fletë, si A1:B2, zbatohet për fletën e parë, prandaj emërtoni shprehimisht skedën për të shmangur surpriza kur dikush i rirenditë skedat.

RAW kundrejt USER_ENTERED

Shkrimet kanë nevojë për një valueInputOption:

• RAW ruan saktësisht atë që dërgoni, si tekst. =1+2 ruhet si teksti =1+2.
• USER_ENTERED e trajton hyrjen sikur të ishte shkruar në Sheets: datat bëhen data dhe =1+2 bëhet formulë.

Nëse shkruani tekst që përdoruesit e shkruan në aplikacionin tuaj, përdorni RAW. Me USER_ENTERED, dikush mund të dorëzojë një formulë që ekzekutohet kur një koleg hap sheet-in.

Kuotat dhe gabimet

Që nga shtatori 2026, faqja e kufijve të Sheets API e Google liston:

Nuk ka limit ditor për sa kohë qëndroni brenda kuotave për minutë. Tejkalimi kthen 429: Too many requests, dhe Google rekomandon backoff eksponencial të shkurtuar: prisni më gjatë pas çdo përpjekjeje të dështuar, me një vonesë të rastësishme, deri në një maksimum. Një kërkesë e vetme që zgjat mbi 180 sekonda skadon.

Në praktikë: mos e thirrni API-n në çdo shikim faqeje. Ruajeni në cache të dhënat e sheet-it për një minutë ose më shumë, gruponi leximet me batchGet, dhe gruponi shkrimet aty ku mundeni.

Opsionet dhe kompromiset

Për çdo gjë me shumë përdorues ose të dhëna të ndjeshme, një bazë të dhënash është burimi më i besueshëm i së vërtetës. Shihni çfarë është një bazë të dhënash.

Kërkesa për ndërtuesin tuaj të AI

Leximi i një sheet:

Shfaq skedën „Menu" të Google Sheet-it tonë në faqen e menusë. Përdor Google Sheets API nga serveri me një llogari shërbimi, çelësi JSON i së cilës është në sekretin GOOGLE_SERVICE_ACCOUNT_JSON, dhe ID-ja e fletëllogaritësit në SHEET_ID. Lexo diapazonin Menu!A2:D (emri, përshkrimi, çmimi, kategoria). Ruaj rezultatin në cache për 5 minuta. Nëse API dështon, shfaq versionin e fundit në cache. Mos e dërgo kurrë çelësin te shfletuesi.

Shkrimi i rreshtave:

Kur dikush dërgon formularin e kontaktit, ruaje në bazën tonë të të dhënave dhe shto gjithashtu një rresht në skedën „Leads" (data, emri, email, mesazhi) duke përdorur spreadsheets.values.append me valueInputOption RAW. Nëse Google kthen 429, provo sërish me backoff eksponencial; nëse akoma dështon, mbaje kontaktin në bazën e të dhënave dhe provoje më vonë.

Gabimet e zakonshme

• Harresa për ta ndarë sheet-in me email-in e llogarisë së shërbimit. API kthen atëherë një gabim leje edhe pse çelësi është në rregull.
• Çelësi në frontend ose në repozitor. Çelësi JSON jep akses te çdo sheet i ndarë me të. Shihni si t'i mbani të sigurta çelësat API.
• Përdorimi i USER_ENTERED për hyrjen e përdoruesit, gjë që lejon injektimin e formulave.
• Thirrja e API-t në çdo kërkesë dhe arritja e kuotës për minutë në rritjen e parë të trafikut.
• Varësia nga pozicionet e kolonave. Dikush shton një kolonë dhe aplikacioni lexon të dhëna të gabuara. Lexoni rreshtin e kokës dhe lidhni sipas emrit, ose mbroni kokën.
• Ndarja e sheet-it më gjerësisht se sa nevojitet. „Kushdo me lidhjen" e bën atë publik.
• Përdorimi i një sheet si bazë të dhënash me shumë përdorues. Shkrimet paralele dhe lejet që mungojnë shkaktojnë humbje ose rrjedhje të të dhënave.

Lista e kontrollit

• Sheets API i aktivizuar; llogaria e shërbimit e krijuar
• Sheet-i i ndarë me email-in e llogarisë së shërbimit me rolin më të ulët të nevojshëm
• Çelësi dhe ID-ja e sheet-it të ruajtura si sekrete në server
• Të gjitha thirrjet bëhen nga serveri
• Emrat e skedave përdoren në diapazone
• RAW përdoret për tekstin e dhënë nga përdoruesi
• Leximet ruhen në cache; 429 trajtohet me backoff
• Aplikacioni vazhdon të funksionojë në mënyrë të pranueshme nëse Sheets nuk është në dispozicion
• Vendosur cila anë është burimi i së vërtetës

Google Sheets në Mythex

Mythex ka dy mënyra të ndryshme për të punuar me Sheets. Connectors lidhin llogarinë tuaj Google me Mythex, që agjenti ta përdorë ndërsa ndërtoni, për shembull duke lexuar një sheet për të ndërtuar një dashboard prej tij; dokumentacioni thotë se kredenciali mbetet te shërbimi i lidhjes i Mythex dhe nuk arrin kurrë në kodin tuaj (shihni Connectors, dhe miratoni çdo leje që kërkon Google). Që aplikacioni i publikuar të lexojë ose shkruajë një sheet vetë, rruga e besueshme është ajo e këtij udhëzuesi: një çelës llogarie shërbimi i ruajtur si sekret projekti dhe thirrje Sheets API nga serveri juaj, si në Integro çdo API. Nëse po e kaloni sheet-in, kërkojini agjentit të zhvendosë të dhënat në bazën e të dhënave të projektit dhe të ndërtojë një dashboard mbi të.

Pyetje