Kako povezati Google Sheets z aplikacijo

Google Sheets povežete z aplikacijo tako, da v projektu Google Cloud omogočite Google Sheets API, ustvarite račun storitve, z njegovim e-poštnim naslovom delite preglednico in njegov ključ shranite kot skrivnost na strežniku. Vaš strežnik nato bere vrstice z spreadsheets.values.get in dodaja vrstice z spreadsheets.values.append. Če morajo uporabniki povezati svoje preglednice, uporabite OAuth; če je preglednica popolnoma javna, za branje zadostuje preprost API ključ.

Ta vodnik pojasnjuje, katera metoda ustreza, katere klice potrebujete, kvote in pasti ter pozive za gradnik aplikacij z AI. Podrobnosti Google so iz Googlove razvijalske dokumentacije na dan september 2026.

Zakaj sploh povezati preglednico

Pogosti razlogi:

• Ohranitev delovnega toka ekipe. Sodelavci še vedno urejajo cenik ali urnik v Sheets, aplikacija pa ga prikaže.
• Zbiranje podatkov tam, kjer ljudje že gledajo. Nove prijave, naročila ali odgovori na obrazce pristanejo kot vrstice.
• Poročanje. Podatke aplikacije izvozite v preglednico za ljudi, ki živijo v preglednicah.
• Stopnica. Začnite s preglednico, nato preidite na pravo bazo. Glejte kako spremeniti preglednico v aplikacijo.

Izberite, kako se aplikacija prijavi pri Googlu

Vodnik Googla za poverilnice opisuje tri vrste:

Za večino aplikacij je pravi izbor račun storitve: en sam nabor poverilnic, ki je v vaši lasti, z dostopom samo do preglednic, ki jih izrecno delite z njim.

Korak za korakom z računom storitve

1. Ustvarite ali izberite projekt Google Cloud in omogočite Google Sheets API.
2. Ustvarite račun storitve in zanj ključ. Ključ je datoteka JSON; ravnajte z njim kot z geslom.
3. Delite preglednico z e-poštnim naslovom računa storitve, kot Viewer za samo branje ali Editor za pisanje. Googlov vodnik pravi, da se to naredi prek običajnega zaslona za deljenje.
4. Shranite ključ kot skrivnost na strežniku, na primer GOOGLE_SERVICE_ACCOUNT_JSON, ter ID preglednice (dolg niz v naslovu URL preglednice) kot SHEET_ID.
5. Pokličite API z strežnika z Googlovo odjemalsko knjižnico za vaš jezik.
6. Predpomnite branja, če si isti podatki ogledujejo številni obiskovalci, da ne presežete kvote.

Klici, ki jih boste uporabljali

Iz Googlovega vodnika za branje in pisanje vrednosti:

Območja uporabljajo zapis A1. Google opozarja, da območje brez imena lista, kot je A1:B2, velja za prvi list, zato ime zavihka navedite izrecno, da ne bo presenečenj, ko nekdo preuredi zavihke.

RAW proti USER_ENTERED

Pri pisanju potrebujete valueInputOption:

• RAW shrani natanko to, kar pošljete, kot besedilo. =1+2 se shrani kot besedilo =1+2.
• USER_ENTERED obravnava vnos, kot da bi bil vpisan v Sheets: datumi postanejo datumi, =1+2 pa formula.

Če pišete besedilo, ki so ga uporabniki vpisali v aplikacijo, uporabite RAW. Pri USER_ENTERED bi lahko nekdo oddal formulo, ki se izvede, ko sodelavec odpre preglednico.

Kvote in napake

Po stanju september 2026 Googlova stran z omejitvami Sheets API navaja:

Dnevne omejitve ni, če ostanete znotraj minutnih kvot. Čez mejo se vrne 429: Too many requests, Google pa priporoča postopno podaljševanje čakalnega časa (truncated exponential backoff): po vsakem neuspelem poskusu počakajte dlje, z naključnim zamikom, do največje vrednosti. Ena sama zahteva, ki traja več kot 180 sekund, poteče.

V praksi: API ne kličite ob vsakem ogledu strani. Podatke preglednice predpomnite vsaj eno minuto, branja združite z batchGet, pisanja pa po možnosti združujte.

Možnosti in kompromisi

Za vse z mnogimi uporabniki ali občutljivimi podatki je baza boljši vir resnice. Glejte kaj je baza podatkov.

Pozivi za vaš gradnik z AI

Branje preglednice:

Na strani z jedilnikom prikaži zavihek „Menu“ naše Google preglednice. Uporabi Google Sheets API s strežnika z računom storitve, katerega JSON ključ je v skrivnosti GOOGLE_SERVICE_ACCOUNT_JSON, ID preglednice pa v SHEET_ID. Preberi območje Menu!A2:D (ime, opis, cena, kategorija). Rezultat predpomni 5 minut. Če API odpove, prikaži zadnjo predpomnjeno različico. Ključa nikoli ne pošlji brskalniku.

Pisanje vrstic:

Ko nekdo odda kontaktni obrazec, ga shrani v našo bazo podatkov in hkrati dodaj vrstico na zavihek „Leads“ (datum, ime, e-pošta, sporočilo) z uporabo spreadsheets.values.append in valueInputOption RAW. Če Google vrne 429, poskusi znova z eksponentnim podaljševanjem čakalnega časa; če tudi to ne uspe, ohrani potencialno stranko v bazi in poskusi pozneje.

Pogoste napake

• Pozabljeno deljenje preglednice z e-poštnim naslovom računa storitve. API nato vrne napako dovoljenja, čeprav je ključ v redu.
• Ključ v frontendu ali repozitoriju. Ključ JSON daje dostop do vseh preglednic, deljenih z njim. Glejte kako varno hraniti API ključe.
• Uporaba USER_ENTERED za vnos uporabnika, kar omogoča vbrizgavanje formul.
• Klicanje API ob vsaki zahtevi in dosego minutne kvote ob prvem skoku prometa.
• Odvisnost od položajev stolpcev. Nekdo vstavi stolpec in aplikacija prebere napačne podatke. Preberite vrstico z glavo in preslikujte po imenu ali zaklenite glavo.
• Deljenje preglednice širše, kot je potrebno. „Vsakdo s povezavo“ jo naredi javno.
• Uporaba preglednice kot večuporabniške baze. Sočasna pisanja in manjkajoča dovoljenja povzročijo izgubo ali uhajanje podatkov.

Kontrolni seznam

• Sheets API omogočen; račun storitve ustvarjen
• Preglednica deljena z e-poštnim naslovom računa storitve z najnižjo potrebno vlogo
• Ključ in ID preglednice shranjena kot skrivnosti na strežniku
• Vsi klici izvedeni s strežnika
• Imena zavihkov uporabljena v območjih
• Za besedilo, ki ga poda uporabnik, uporabljen RAW
• Branja predpomnjena; 429 obravnavan s postopnim podaljševanjem čakanja
• Aplikacija se elegantno odzove, če Sheets ni na voljo
• Odločeno, katera stran je vir resnice

Google Sheets v Mythexu

Mythex ima dva različna načina dela s Sheets. Konektorji povežejo vaš Google račun z Mythexom, da ga agent lahko uporabi med gradnjo, na primer za branje preglednice in gradnjo nadzorne plošče iz nje. Dokumentacija pravi, da poverilnica ostane pri Mythexovi storitvi povezovanja in nikoli ne pride v vašo kodo (glejte Konektorji; vsako dovoljenje, ki ga Google zahteva, odobrite). Da objavljena aplikacija sama bere ali piše v preglednico, je zanesljiva pot tista iz tega vodnika: ključ računa storitve kot skrivnost projekta in klici Sheets API z vašega strežnika, kot je opisano v Integrate any API. Če jo preglednica prerašča, agenta prosite, naj podatke prenese v bazo projekta in na njej zgradi nadzorno ploščo.

Vprašanja