Ako pripojiť Google Sheets k vašej aplikácii

Na pripojenie Google Sheets k aplikácii zapnite Google Sheets API v projekte Google Cloud, vytvorte service account, zdieľajte tabuľku s e-mailovou adresou service accountu a jeho kľúč uložte ako tajomstvo na strane servera. Server potom číta riadky cez spreadsheets.values.get a pridáva riadky cez spreadsheets.values.append. Ak si majú používatelia pripájať vlastné tabuľky, použite namiesto toho OAuth; ak je tabuľka úplne verejná, na čítanie stačí jednoduchý API kľúč.

Tento sprievodca vysvetľuje, ktorý spôsob sa hodí, aké volania potrebujete, kvóty a úskalia a aj prompty pre nástroj na tvorbu aplikácií s AI. Údaje o Google vychádzajú z vývojárskej dokumentácie Google k septembru 2026.

Prečo vôbec pripájať tabuľku

Bežné dôvody:

• Zachovanie pracovného postupu tímu. Zamestnanci ďalej upravujú cenník alebo rozvrh v Sheets; aplikácia ho zobrazuje.
• Zber dát tam, kde sa ľudia už pozerajú. Nové registrácie, objednávky alebo odpovede z formulárov pribúdajú ako riadky.
• Reporting. Export dát z aplikácie do tabuľky pre ľudí, ktorí pracujú v tabuľkách.
• Odrazový mostík. Začnite z tabuľky a neskôr prejdite na riadnu databázu. Pozrite ako premeniť tabuľku na aplikáciu.

Vyberte, ako sa aplikácia prihlasuje ku Google

Sprievodca Google k poverovacím údajom popisuje tri typy:

Pre väčšinu aplikácií je správnou voľbou service account: jedna sada poverení, ktorú vlastníte vy, s prístupom len k tabuľkám, ktoré mu výslovne zdieľate.

Krok za krokom so service accountom

1. Vytvorte alebo vyberte projekt Google Cloud a zapnite Google Sheets API.
2. Vytvorte service account a pre neho kľúč. Kľúč je JSON súbor; zaobchádzajte s ním ako s heslom.
3. Zdieľajte tabuľku s e-mailovou adresou service accountu ako Viewer pre čítanie alebo Editor pre zápis. Sprievodca Google uvádza, že sa to robí bežnou obrazovkou zdieľania.
4. Uložte kľúč ako tajomstvo na serveri, napríklad GOOGLE_SERVICE_ACCOUNT_JSON, a ID tabuľky (dlhý reťazec v URL tabuľky) ako SHEET_ID.
5. Volajte API zo servera pomocou klientskej knižnice Google pre váš jazyk.
6. Ukladajte čítania do vyrovnávacej pamäte, ak tie isté dáta vidí veľa návštevníkov, aby ste nenarážali na kvótu.

Volania, ktoré budete používať

Z návodu Google na čítanie a zápis hodnôt:

Rozsahy používajú zápis A1. Google upozorňuje, že rozsah bez názvu hárku, napríklad A1:B2, sa vzťahuje na prvý hárok, preto názov karty uvádzajte výslovne, aby vás nepoložilo, keď niekto zmení poradie kariet.

RAW vs. USER_ENTERED

Zápisy potrebujú valueInputOption:

• RAW uloží presne to, čo pošlete, ako text. =1+2 sa uloží ako text =1+2.
• USER_ENTERED spracuje vstup ako údaj zadaný do Sheets: dátumy sa stanú dátumami a =1+2 sa stane vzorcom.

Ak zapisujete text, ktorý používatelia napísali vo vašej aplikácii, použite RAW. Pri USER_ENTERED by niekto mohol odoslať vzorec, ktorý sa spustí, keď ho kolega otvorí v tabuľke.

Kvóty a chyby

K septembru 2026 stránka limitov Sheets API od Google uvádza:

Denný limit neexistuje, pokiaľ zostanete v minútových kvótach. Pri prekročení vráti 429: Too many requests a Google odporúča exponenciálne čakanie s ohraničením: po každom neúspešnom pokuse čakajte dlhšie, s náhodným oneskorením, až do maxima. Jedna požiadavka, ktorá trvá viac ako 180 sekúnd, vyprší.

V praxi: nevolajte API pri každom zobrazení stránky. Ukladajte dáta tabuľky do vyrovnávacej pamäte aspoň na minútu, čítania dávkujte cez batchGet a zápisy tam, kde to ide, zoskupte.

Možnosti a kompromisy

Pre čokoľvek s mnohými používateľmi alebo citlivými dátami je lepším zdrojom pravdy databáza. Pozrite čo je databáza.

Prompty pre váš nástroj na tvorbu s AI

Čítanie tabuľky:

Zobrazuj kartu „Menu“ z nášho Google Sheetu na stránke s menu. Použi Google Sheets API zo servera so service accountom, ktorého JSON kľúč je v tajomstve GOOGLE_SERVICE_ACCOUNT_JSON, a ID tabuľky v SHEET_ID. Prečítaj rozsah Menu!A2:D (názov, popis, cena, kategória). Výsledok ulož do vyrovnávacej pamäte na 5 minút. Ak API zlyhá, zobraz poslednú uloženú verziu. Kľúč nikdy neposielaj do prehliadača.

Zápis riadkov:

Keď niekto odošle kontaktný formulár, ulož ho do databázy a zároveň pridaj riadok na kartu „Leads“ (dátum, meno, e-mail, správa) pomocou spreadsheets.values.append s valueInputOption RAW. Ak Google vráti 429, opakuj s exponenciálnym čakaním; ak to stále zlyhá, nechaj lead v databáze a skús neskôr.

Časté chyby

• Zabudnutie zdieľať tabuľku s e-mailom service accountu. API potom vráti chybu oprávnenia, aj keď je kľúč v poriadku.
• Kľúč vo frontende alebo v repozitári. JSON kľúč dáva prístup ku každej tabuľke, ktorá je mu zdieľaná. Pozrite ako chrániť API kľúče.
• Použitie USER_ENTERED pre vstup od používateľov, čo umožňuje vkladanie vzorcov.
• Volanie API pri každej požiadavke a narazenie na minútovú kvótu pri prvom špičkovom nápore návštevnosti.
• Spoliehanie sa na poradie stĺpcov. Niekto vloží stĺpec a aplikácia načíta nesprávne dáta. Čítajte riadok hlavičky a mapujte podľa názvu, alebo hlavičku zamknite.
• Zdieľanie tabuľky širšie, než je potrebné. „Ktokoľvek s odkazom“ ju robí verejnou.
• Používanie tabuľky ako viacpoužívateľskej databázy. Súbežné zápisy a chýbajúce oprávnenia spôsobia stratu alebo únik dát.

Kontrolný zoznam

• Sheets API zapnuté; service account vytvorený
• Tabuľka zdieľaná s e-mailom service accountu s najnižšou potrebnou rolou
• Kľúč a ID tabuľky uložené ako tajomstvá na serveri
• Všetky volania sa robia zo servera
• Názvy kariet použité v rozsahoch
• RAW použité pre text zadaný používateľmi
• Čítania uložené do vyrovnávacej pamäte; 429 ošetrené čakaním
• Aplikácia sa elegantne vyrovná s nedostupnosťou Sheets
• Rozhodnuté, ktorá strana je zdrojom pravdy

Google Sheets v Mythex

Mythex má dva rôzne spôsoby práce so Sheets. Konektory prepoja váš účet Google s Mythex, aby ho agent mohol používať počas tvorby, napríklad na čítanie tabuľky a zostavenie dashboardu z nej; dokumentácia uvádza, že poverenie zostáva v službe pripojení Mythex a nikdy sa nedostane do vášho kódu (pozrite Konektory a schváľte každé oprávnenie, o ktoré Google požiada). Ak má publikovaná aplikácia čítať alebo zapisovať do tabuľky sama, spoľahlivou cestou je postup z tohto sprievodcu: kľúč service accountu uložený ako tajomstvo projektu a volania Sheets API zo servera, ako v Integrácia akéhokoľvek API. Ak tabuľka prestáva stačiť, požiadajte agenta, aby preniesol dáta do databázy projektu a nad ňou postavil dashboard.

Otázky