Kuidas ühendada Google Sheets oma rakendusega

Google Sheetsi ühendamiseks rakendusega luba Google Sheets API Google Cloudi projektis, loo teenusekonto, jaga tabelit teenusekonto e-posti aadressiga ja salvesta selle võti serveripoolse saladusena. Sinu server loeb seejärel ridu meetodiga spreadsheets.values.get ja lisab ridu meetodiga spreadsheets.values.append. Kui kasutajad peavad ühendama oma tabelid, kasuta OAuth-i, ja kui tabel on täiesti avalik, piisab lugemiseks lihtsast API-võtmest.

See juhend käsitleb, milline meetod sobib, vajalikke päringuid, piiranguid ja probleemkohti ning promptide näiteid tehisintellekti rakenduste koostajale. Google’i üksikasjad on pärit Google’i arendajadokumentatsioonist seisuga september 2026.

Miks tabel üldse ühendada

Levinud põhjused:

• Säilita tiimi töövoog. Töötajad muudavad jätkuvalt hinnakirja või ajakava Sheetsis; rakendus kuvab selle.
• Kogu andmeid sinna, kus inimesed juba vaatavad. Uued registreerimised, tellimused või vormivastused jõuavad ridadena.
• Aruandlus. Ekspordi rakenduse andmed tabelisse inimestele, kes elavad tabelarvutustes.
• Hüppelaud. Alusta tabelist ja kolid seejärel korraliku andmebaasi juurde. Vaata kuidas muuta tabel rakenduseks.

Vali, kuidas su rakendus Google’i-ga sisse logib

Google’i volitusjuhend kirjeldab kolme tüüpi:

Enamikule rakendustele sobib teenusekonto: üks volituste komplekt, mis kuulub sulle, ja juurdepääs ainult tabelitele, mille oled selgesõnaliselt sellega jaganud.

Samm-sammult teenusekontoga

1. Loo või vali Google Cloudi projekt ja luba Google Sheets API.
2. Loo teenusekonto ja selle võti. Võti on JSON-fail; käsitle seda nagu parooli.
3. Jaga tabelit teenusekonto e-posti aadressiga: lugemiseks vaataja õigusega või kirjutamiseks toimetaja õigusega. Google’i juhendi järgi tehakse see tavalise jagamisekraani kaudu.
4. Salvesta võti serveri saladusena, näiteks GOOGLE_SERVICE_ACCOUNT_JSON, ning tabeli ID (pikk string tabeli URL-is) nimega SHEET_ID.
5. Kutsu API-d serverist Google’i kliendiraamatukoguga oma keele jaoks.
6. Vahemällu lugemised, kui paljud külastajad näevad samu andmeid, et kvoodile liiga ei jõuaks.

Päringud, mida kasutad

Google’i juhendist andmete lugemise ja kirjutamise kohta:

Vahemikud kasutavad A1-notatsiooni. Google märgib, et vahemik ilma lehe nimeta, näiteks A1:B2, kehtib esimesele lehele, seega nimeta vahekaart selgesõnaliselt, et vältida üllatusi, kui keegi vahekaarte ümber paigutab.

RAW vs USER_ENTERED

Kirjutamine vajab valueInputOption väärtust:

• RAW salvestab täpselt saadetud sisu tekstina. =1+2 salvestatakse tekstina =1+2.
• USER_ENTERED käsitleb sisendit nii, nagu oleks see Sheetsi sisestatud: kuupäevad muutuvad kuupäevadeks ja =1+2 valemiks.

Kui kirjutad rakendusse kasutaja sisestatud teksti, kasuta RAW-i. USER_ENTERED korral võib keegi esitada valemi, mis käivitub, kui kolleeg tabeli avab.

Piirangud ja vead

Seisuga september 2026 loetleb Google’i Sheets API piirangute leht:

Päevapiirangut ei ole, kui jääd minutipiiride sisse. Piiri ületamisel tuleb 429: Too many requests, ja Google soovitab katkestatud eksponentsiaalset ooterežiimi: oota iga ebaõnnestunud katse järel pikemalt, juhusliku viivitusega, kuni maksimumini. Üksik päring, mis kestab üle 180 sekundi, aegub.

Praktikas: ära kutsu API-d iga lehevaatamise puhul. Vahemällu tabeli andmed vähemalt minutiks, grupeeri lugemised batchGet-iga ja grupeeri kirjutamised, kus võimalik.

Valikud ja kompromissid

Kõige suurema kasutajaarvu või tundlike andmete korral on andmebaas parem tõe allikas. Vaata mis on andmebaas.

Promptid tehisintellekti rakenduste koostajale

Tabeli lugemine:

Näita meie Google’i tabeli lehe „Menu“ sisu menüülehel. Kasuta Google Sheets API-d serveris teenusekontoga, mille JSON-võti on saladuses GOOGLE_SERVICE_ACCOUNT_JSON ja tabeli ID on SHEET_ID. Loe vahemik Menu!A2:D (nimi, kirjeldus, hind, kategooria). Vahemällu tulemus 5 minutiks. Kui API ebaõnnestub, näita viimast vahemällu salvestatud versiooni. Võtit ei saadeta kunagi brauserisse.

Ridade kirjutamine:

Kui keegi saadab kontaktivormi, salvesta see andmebaasi ning lisa rida vahekaardile „Leads“ (kuupäev, nimi, e-post, sõnum), kasutades spreadsheets.values.append meetodit valueInputOption väärtusega RAW. Kui Google tagastab 429, proovi uuesti eksponentsiaalse ooteajaga; kui see ikka ebaõnnestub, jäta lead andmebaasi ja proovi hiljem uuesti.

Levinud vead

• Tabeli jagamise unustamine teenusekonto e-posti aadressiga. API tagastab siis loavea, kuigi võti on korras.
• Võti esikülgel või repositooriumis. JSON-võti annab ligipääsu kõigile tabelitele, mis sellega on jagatud. Vaata kuidas hoida API-võtmed turvalisena.
• USER_ENTERED kasutamine kasutaja sisendi jaoks, mis lubab valemi süstimist.
• API kutsumine igal lehevaatamisel ja minutipiirangu ületamine esimeses liiklustipus.
• Sõltumine veergude positsioonidest. Keegi lisab veeru ja rakendus loeb valesid andmeid. Loe päiserida ja seosta nime järgi, või lukusta päis.
• Tabeli jagamine laiemalt kui vaja. „Igaüks, kellel on link“ muudab selle avalikuks.
• Tabeli kasutamine mitme kasutajaga andmebaasina. Samaaegsed kirjutamised ja puuduvad õigused põhjustavad andmete kadumise või lekke.

Kontrollnimekiri

• Sheets API on lubatud; teenusekonto on loodud
• Tabel on jagatud teenusekonto e-postiga väikseima vajaliku rolliga
• Võti ja tabeli ID on salvestatud serveri saladustena
• Kõik kutsed tehakse serverist
• Vahemikes kasutatakse vahekaartide nimesid
• Kasutaja poolt sisestatud tekst kasutab RAW-d
• Lugemised on vahemällus; 429 käsitletakse ooterežiimiga
• Rakendus toimib kenasti, kui Sheets on kättesaamatu
• On otsustatud, kumb pool on tõe allikas

Google Sheets Mythexis

Mythexis on Google Sheetsiga kaks erinevat viisi töötamiseks. Konnektorid ühendavad sinu Google’i konto Mythexiga, nii et agent saab seda ehitamise ajal kasutada, näiteks tabeli lugemiseks ja sellest armatuurlaua ehitamiseks; dokumentatsiooni järgi jääb volitus Mythexi ühenduste teenusesse ega jõua kunagi sinu koodi (vaata Konnektorid ja kiida heaks iga luba, mida Google küsib). Avaldatud rakendus, mis loeb või kirjutab tabelit iseseisvalt, tugineb selle juhendi viisile: teenusekonto võti salvestatakse projekti saladusena ja Sheets API päringud tehakse sinu serverist, nagu juhendis Integrate any API. Kui tabelist välja kasvad, palu agendil viia andmed projekti andmebaasi ja ehitada selle peale armatuurlaud.

Küsimused