Kako povezati Google Sheets s aplikacijom

Za povezivanje Google Sheets s aplikacijom uključite Google Sheets API u Google Cloud projektu, napravite servisni račun, podijelite tablicu s e-mail adresom servisnog računa i spremite njegov ključ kao tajnu vrijednost na poslužitelju. Vaš poslužitelj zatim čita retke pomoću spreadsheets.values.get, a dodaje ih pomoću spreadsheets.values.append. Ako korisnici trebaju povezati vlastite tablice, koristite OAuth; a ako je tablica potpuno javna, za čitanje je dovoljan jednostavan API ključ.

Ovaj vodič pokriva koja metoda odgovara, potrebne pozive, kvote i zamke te upite za alat za izradu aplikacija uz AI. Podaci o Googleu su iz Googleove developer dokumentacije od rujna 2026.

Zašto uopće povezivati tablicu

Uobičajeni razlozi:

• Zadržavanje radnog tijeka tima. Zaposlenici i dalje uređuju cjenik ili raspored u Sheetsu; aplikacija ga prikazuje.
• Prikupljanje podataka tamo gdje ljudi već gledaju. Nove registracije, narudžbe ili odgovori obrazaca dolaze kao reci.
• Izvještavanje. Izvoz podataka iz aplikacije u tablicu za ljude koji rade u tablicama.
• Polazna točka. Počnite s tablicom, zatim prijeđite na pravu bazu podataka. Pogledajte kako pretvoriti tablicu u aplikaciju.

Odaberite kako se vaša aplikacija prijavljuje kod Googlea

Googleov vodič za vjerodajnice opisuje tri vrste:

Za većinu aplikacija servisni račun je pravi izbor: jedan skup vjerodajnica, u vašem vlasništvu, s pristupom samo tablicama koje izričito podijelite s njim.

Korak po korak sa servisnim računom

1. Napravite ili odaberite Google Cloud projekt i uključite Google Sheets API.
2. Napravite servisni račun i njegov ključ. Ključ je JSON datoteka; čuvajte ga kao lozinku.
3. Podijelite tablicu s e-mail adresom servisnog računa, kao Viewer za samo čitanje ili Editor za pisanje. Googleov vodič kaže da se to radi preko uobičajenog zaslona za dijeljenje.
4. Spremite ključ kao tajnu vrijednost na poslužitelju, na primjer GOOGLE_SERVICE_ACCOUNT_JSON, te ID tablice (dugi niz u URL-u tablice) kao SHEET_ID.
5. Pozivajte API s poslužitelja pomoću Googleove klijentske biblioteke za vaš jezik.
6. Predmemorirajte čitanja ako isti podaci vide mnogi posjetitelji, kako ne biste dosegnuli kvotu.

Pozivi koje ćete koristiti

Iz Googleova vodiča za čitanje i pisanje vrijednosti:

Raspon koristi A1 notaciju. Google napominje da raspon bez naziva lista, poput A1:B2, vrijedi za prvi list, pa eksplicitno imenujte karticu kako biste izbjegli iznenađenja kada netko preslaže kartice.

RAW naspram USER_ENTERED

Pisanje zahtijeva valueInputOption:

• RAW sprema točno ono što pošaljete, kao tekst. =1+2 se sprema kao tekst =1+2.
• USER_ENTERED tretira unos kao da je upisan u Sheets: datumi postaju datumi, a =1+2 postaje formula.

Ako pišete tekst koji su korisnici upisali u vašu aplikaciju, koristite RAW. S USER_ENTERED netko bi mogao poslati formulu koja se izvrši kada kolega otvori tablicu.

Kvote i greške

Od rujna 2026. Googleova stranica o ograničenjima Sheets API-ja navodi:

Nema dnevnog ograničenja dok ostajete unutar minutnih kvota. Prekoračenje vraća 429: Too many requests, a Google preporučuje skraćeno eksponencijalno čekanje: čekajte duže nakon svakog neuspjelog pokušaja, uz nasumično kašnjenje, do određenog maksimuma. Jedan zahtjev koji traje duže od 180 sekundi istječe zbog isteka vremena.

U praksi: nemojte pozivati API pri svakom prikazu stranice. Predmemorirajte podatke tablice na minutu ili duže, grupirajte čitanja s batchGet i grupirajte pisanja gdje možete.

Opcije i kompromisi

Za sve s mnogo korisnika ili osjetljivim podacima, baza podataka je bolji izvor istine. Pogledajte što je baza podataka.

Upiti za vaš AI alat za izradu

Čitanje tablice:

Prikaži karticu „Menu” naše Google tablice na stranici jelovnika. Koristi Google Sheets API s poslužitelja sa servisnim računom čiji je JSON ključ u tajni GOOGLE_SERVICE_ACCOUNT_JSON, a ID tablice u SHEET_ID. Čitaj raspon Menu!A2:D (naziv, opis, cijena, kategorija). Predmemoriraj rezultat 5 minuta. Ako API ne uspije, prikaži zadnju predmemoriranu verziju. Nikada ne šalji ključ pregledniku.

Pisanje redaka:

Kada netko pošalje kontakt obrazac, spremi ga u našu bazu podataka i dodaj redak na karticu „Leads” (datum, ime, e-mail, poruka) pomoću spreadsheets.values.append s valueInputOption RAW. Ako Google vrati 429, pokušaj ponovno s eksponencijalnim čekanjem; ako i dalje ne uspije, zadrži upit u bazi podataka i pokušaj kasnije.

Česte pogreške

• Zaboravljanje da podijelite tablicu s e-mail adresom servisnog računa. API tada vraća grešku dozvola, iako je ključ ispravan.
• Ključ u frontendu ili repozitoriju. JSON ključ daje pristup svakoj tablici podijeljenoj s njim. Pogledajte kako čuvati API ključeve sigurnima.
• Korištenje USER_ENTERED za unos korisnika, što dopušta injekciju formula.
• Pozivanje API-ja pri svakom zahtjevu i dosezanje minutne kvote pri prvom skoku prometa.
• Oslanjanje na pozicije stupaca. Netko umetne stupac i aplikacija čita pogrešne podatke. Čitajte red zaglavlja i mapirajte po nazivu, ili zaključajte zaglavlje.
• Dijeljenje tablice šire nego što treba. „Anyone with the link” je čini javnom.
• Korištenje tablice kao višekorisničke baze podataka. Istodobna pisanja i nedostajuće dozvole uzrokuju izgubljene ili procurjele podatke.

Popis za provjeru

• Sheets API uključen; servisni račun napravljen
• Tablica podijeljena s e-mail adresom servisnog računa s najmanjom potrebnom ulogom
• Ključ i ID tablice spremljeni kao tajne vrijednosti na poslužitelju
• Svi pozivi se rade s poslužitelja
• Nazivi kartica korišteni u rasponima
• RAW korišten za tekst koji daju korisnici
• Čitanja predmemorirana; 429 obrađen čekanjem
• Aplikacija se elegantno snalazi ako Sheets nije dostupan
• Odlučeno koja strana je izvor istine

Google Sheets u Mythexu

Mythex ima dva različita načina rada s Sheetsom. Konektori povezuju vaš Google račun s Mythexom tako da ga agent može koristiti dok gradite, na primjer za čitanje tablice i izradu nadzorne ploče iz nje; dokumentacija kaže da vjerodajnica ostaje kod Mythexove usluge za povezivanje i nikada ne završi u vašem kodu (pogledajte Konektori, i odobrite svaku dozvolu koju Google traži). Da objavljena aplikacija sama čita ili piše u tablicu, pouzdan je put onaj iz ovog vodiča: ključ servisnog računa spremljen kao tajna vrijednost projekta i pozivi Sheets API-ju s vašeg poslužitelja, kao u Integrate any API. Ako prerastete tablicu, zamolite agenta da premjesti podatke u bazu podataka projekta i izgradi nadzornu ploču nad njima.

Pitanja