Kako povezati Google Sheets sa aplikacijom

Da povežete Google Sheets sa aplikacijom, omogućite Google Sheets API u Google Cloud projektu, napravite servisni nalog, podijelite tabelu sa email adresom servisnog naloga i sačuvajte njegov ključ kao tajnu na serveru. Vaš server zatim čita redove sa spreadsheets.values.get i dodaje redove sa spreadsheets.values.append. Ako korisnici trebaju povezati svoje tabele, koristite OAuth, a ako je tabela potpuno javna, za čitanje je dovoljan jednostavan API ključ.

Ovaj vodič pokriva koja metoda odgovara, pozive koji su vam potrebni, kvote i zamke, te prompte za AI alat za izradu aplikacija. Detalji o Google-u su iz Google-ove razvojne dokumentacije od septembra 2026.

Zašto uopšte povezivati tabelu

Uobičajeni razlozi:

• Zadržavanje timinog toka rada. Osoblje i dalje uređuje cjenovnik ili raspored u Sheetsu; aplikacija ih prikazuje.
• Prikupljanje podataka tamo gdje ljudi već gledaju. Nove registracije, narudžbe ili odgovori na forme stižu kao redovi.
• Izvještavanje. Izvezite podatke iz aplikacije u tabelu za ljude koji žive u tabelarnim proračunima.
• Stepenik ka nečemu boljem. Počnite od tabele, pa prijeđite na pravu bazu. Pogledajte kako pretvoriti tabelu u aplikaciju.

Izaberite kako se aplikacija prijavljuje na Google

Google vodič o vjerodajnicama opisuje tri vrste:

Za većinu aplikacija, servisni nalog je pravi izbor: jedan skup vjerodajnica, u vašem vlasništvu, sa pristupom samo tabelama koje eksplicitno podijelite s njim.

Korak po korak sa servisnim nalogom

1. Napravite ili odaberite Google Cloud projekat i omogućite Google Sheets API.
2. Napravite servisni nalog i ključ za njega. Ključ je JSON fajl; tretirajte ga kao lozinku.
3. Podijelite tabelu sa email adresom servisnog naloga, kao Viewer za samo čitanje ili Editor za pisanje. Google vodič kaže da se to radi kroz uobičajen ekran za dijeljenje.
4. Sačuvajte ključ kao tajnu na vašem serveru, na primjer GOOGLE_SERVICE_ACCOUNT_JSON, plus ID tabele (dugi niz u URL-u tabele) kao SHEET_ID.
5. Pozovite API sa servera koristeći Google-ovu klijentsku biblioteku za vaš jezik.
6. Keširajte čitanja ako isti podaci vide mnogi posjetioci, da ne dostignete kvotu.

Pozivi koje ćete koristiti

Iz Google vodiča o čitanju i pisanju vrijednosti:

Opsezi koriste A1 notaciju. Google napominje da opseg bez imena lista, kao A1:B2, važi za prvi list, pa imenujte karticu eksplicitno da izbjegnete iznenađenja kada neko promijeni redoslijed kartica.

RAW naspram USER_ENTERED

Pisanje zahtijeva valueInputOption:

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

Ako pišete tekst koji su korisnici unijeli u vašu aplikaciju, koristite RAW. Sa USER_ENTERED, neko može poslati formulu koja se izvrši kada kolega otvori tabelu.

Kvote i greške

Od septembra 2026, Google-ova stranica o ograničenjima Sheets API-ja navodi:

Nema dnevnog ograničenja dok ostajete u minutnim kvotama. Prekoračenje vraća 429: Too many requests, a Google preporučuje eksponencijalno čekanje sa skraćenjem: čekajte duže nakon svakog neuspjelog pokušaja, uz slučajno kašnjenje, do maksimuma. Jedan zahtjev koji traje duže od 180 sekundi istječe zbog isteka vremena.

U praksi: ne zovite API pri svakom prikazu stranice. Keširajte podatke tabele minut ili duže, grupišite čitanja sa batchGet, i grupišite pisanja gdje možete.

Opcije i kompromisi

Za sve sa mnogo korisnika ili osjetljivim podacima, baza je bolji glavni izvor podataka. Pogledajte šta je baza podataka.

Prompti za vaš AI alat za izradu

Čitanje tabele:

Prikaži karticu „Menu” naše Google tabele na stranici za meni. Koristi Google Sheets API sa servera, sa servisnim nalogom čiji je JSON ključ u tajni GOOGLE_SERVICE_ACCOUNT_JSON, a ID tabele u SHEET_ID. Čitaj opseg Menu!A2:D (naziv, opis, cijena, kategorija). Keširaj rezultat 5 minuta. Ako API ne uspije, prikaži zadnju keširanu verziju. Ključ nikada ne šalji u pretraživač.

Pisanje redova:

Kada neko pošalje kontakt formu, sačuvaj je u našu bazu i dodaj red na karticu „Leads” (datum, ime, email, poruka) koristeći spreadsheets.values.append sa valueInputOption RAW. Ako Google vrati 429, pokušaj ponovo uz eksponencijalno čekanje; ako i dalje ne uspije, zadrži lead u bazi i pokušaj kasnije.

Česte greške

• Zaboravljeno dijeljenje tabele sa email adresom servisnog naloga. API tada vraća grešku dozvola iako je ključ ispravan.
• Ključ u frontendu ili repozitorijumu. JSON ključ daje pristup svakoj tabeli podijeljenoj s njim. Pogledajte kako čuvati API ključeve bezbjednim.
• Korištenje USER_ENTERED za unos korisnika, što omogućava ubacivanje formula.
• Pozivanje API-ja pri svakom zahtjevu i dostizanje minutne kvote na prvom skoku saobraćaja.
• Oslanjanje na pozicije kolona. Neko ubaci kolonu, aplikacija čita pogrešne podatke. Čitajte red zaglavlja i mapirajte po imenu, ili zaključajte zaglavlje.
• Dijeljenje tabele šire nego što treba. „Svako ko ima link” je čini javnom.
• Korištenje tabele kao baze za više korisnika. Istovremeni upisi i nedostajuće dozvole dovode do izgubljenih ili procurelih podataka.

Kontrolna lista

• Sheets API omogućen; servisni nalog napravljen
• Tabela podijeljena sa email adresom servisnog naloga sa najnižom potrebnom ulogom
• Ključ i ID tabele sačuvani kao tajne na serveru
• Svi pozivi se prave sa servera
• Nazivi kartica korišćeni u opsezima
• RAW korišćen za tekst koji unose korisnici
• Čitanja keširana; 429 obrađen čekanjem
• Aplikacija radi bez problema ako Sheets nije dostupan
• Odlučeno koja strana je glavni izvor podataka

Google Sheets u Mythexu

Mythex ima dva različita načina rada sa Sheetsom. Konektori povezuju vaš Google nalog sa Mythexom da agent može da ga koristi dok gradite, na primjer čitanje tabele za izradu kontrolne table iz nje; dokumentacija kaže da vjerodajnica ostaje kod Mythexovog servisa za povezivanje i nikada ne ulazi u vaš kod (pogledajte Konektore, i odobrite svaku dozvolu koju Google traži). Da objavljena aplikacija sama čita ili piše u tabelu, pouzdan put je onaj iz ovog vodiča: ključ servisnog naloga sačuvan kao tajna projekta i pozivi Sheets API-ju sa vašeg servera, kao u Integriši bilo koji API. Ako ste prerasli tabelu, zatražite od agenta da prebaci podatke u bazu projekta i izgradi kontrolnu tablu iznad nje.

Pitanja