Kaip prijungti Google Sheets prie savo programos

Norint prijungti Google Sheets prie savo programos, įjunkite Google Sheets API Google Cloud projekte, sukurkite servisinę paskyrą, pasidalykite lentele su servisinės paskyros el. pašto adresu ir jos raktą saugokite kaip serverio pusės paslaptį. Tada jūsų serveris skaito eilutes su spreadsheets.values.get ir prideda eilutes su spreadsheets.values.append. Jei naudotojams reikia prijungti savo lenteles, vietoje to naudokite OAuth, o jei lentelė visiškai vieša, skaitymui pakanka paprasto API rakto.

Šiame vadove aprašoma, koks metodas tinka, kokius kvietimus reikia atlikti, kvotos ir spąstai bei užklausos AI programų kūrimo įrankiui. Google detalės paimtos iš Google kūrėjų dokumentacijos nuo 2026 m. rugsėjo.

Kodėl apskritai jungti lentelę

Dažniausios priežastys:

• Išlaikyti komandos darbo eigą. Darbuotojai toliau redaguoja kainoraštį ar grafiką Sheets, o programa jį rodo.
• Rinkti duomenis ten, kur žmonės jau žiūri. Naujos registracijos, užsakymai ar formos atsakymai atsiranda kaip eilutės.
• Ataskaitos. Eksportuokite programos duomenis į lentelę žmonėms, kurie dirba su skaičiuoklėmis.
• Tarpinis žingsnis. Pradėkite nuo lentelės, o paskui pereikite prie tinkamos duomenų bazės. Žr. kaip paversti skaičiuoklę programa.

Pasirinkite, kaip jūsų programa prisijungia prie Google

Google autentifikavimo vadove aprašyti trys tipai:

Daugeliui programų tinkamiausia servisinė paskyra: vienas prisijungimo duomenų rinkinys, priklausantis jums, su prieiga tik prie lentelių, kurias aiškiai pasidalijote.

Žingsnis po žingsnio su servisine paskyra

1. Sukurkite arba pasirinkite Google Cloud projektą ir įjunkite Google Sheets API.
2. Sukurkite servisinę paskyrą ir jos raktą. Raktas yra JSON failas; elkitės su juo kaip su slaptažodžiu.
3. Pasidalykite lentele su servisinės paskyros el. pašto adresu: Viewer tik skaitymui arba Editor rašymui. Google vadove nurodyta, kad tai daroma įprastame bendrinimo lange.
4. Saugokite raktą kaip paslaptį savo serveryje, pavyzdžiui, GOOGLE_SERVICE_ACCOUNT_JSON, ir lentelės ID (ilgą eilutę lentelės URL) kaip SHEET_ID.
5. Kvieskite API iš serverio naudodami Google kliento biblioteką jūsų programavimo kalbai.
6. Talpinkite skaitymus į talpyklą, jei daug lankytojų mato tuos pačius duomenis, kad neviršytumėte kvotos.

Kvietimai, kuriuos naudosite

Iš Google vadovo, kaip skaityti ir rašyti reikšmes:

Intervalai nurodomi A1 notacija. Google pažymi, kad intervalas be lapo pavadinimo, pavyzdžiui, A1:B2, taikomas pirmam lapui, todėl aiškiai nurodykite skirtuko pavadinimą, kad nebūtų netikėtumų, kai kas nors pertvarko skirtukus.

RAW ir USER_ENTERED

Rašymui reikalingas valueInputOption:

• RAW išsaugo tiksliai tai, ką siunčiate, kaip tekstą. =1+2 išsaugomas kaip tekstas =1+2.
• USER_ENTERED apdoroja įvestį taip, lyg ji būtų įvesta Sheets: datos tampa datomis, o =1+2 tampa formule.

Jei rašote tekstą, kurį naudotojai įvedė jūsų programoje, naudokite RAW. Su USER_ENTERED kas nors gali pateikti formulę, kuri įvyks, kai kolega atidarys lentelę.

Kvotos ir klaidos

Nuo 2026 m. rugsėjo Google Sheets API limitų puslapyje nurodyta:

Dienos limito nėra, jei laikotės minutinių kvotų. Viršijus, grąžinama 429: Too many requests, o Google rekomenduoja eksponentinį laukimo didinimą su apkarpymu: po kiekvieno nepavykusio bandymo laukite ilgiau, su atsitiktiniu vėlavimu, iki maksimumo. Viena užklausa, trunkanti ilgiau nei 180 sekundžių, baigiasi laiko viršijimu.

Praktikoje: nekvieskite API kiekvieno puslapio peržiūros metu. Talpinkite lentelės duomenis į talpyklą bent minutei ar ilgiau, jungkite skaitymus su batchGet ir, kur įmanoma, grupuokite rašymus.

Variantai ir kompromisai

Didelei naudotojų daliai ar jautriems duomenims duomenų bazė yra patikimesnis tiesos šaltinis. Žr. kas yra duomenų bazė.

Užklausos jūsų AI kūrimo įrankiui

Lentelės skaitymas:

Parodyk mūsų Google lentelės skirtuką „Menu“ meniu puslapyje. Naudok Google Sheets API iš serverio su servisine paskyra, kurios JSON raktas yra paslaptyje GOOGLE_SERVICE_ACCOUNT_JSON, o lentelės ID — SHEET_ID. Nuskaityk intervalą Menu!A2:D (pavadinimas, aprašymas, kaina, kategorija). Talpink rezultatą į talpyklą 5 minutėms. Jei API nepavyksta, rodyk paskutinę talpykloje saugotą versiją. Niekada nesiųsk rakto į naršyklę.

Eilučių rašymas:

Kai kas nors pateikia kontaktų formą, išsaugok ją mūsų duomenų bazėje ir taip pat pridėk eilutę prie skirtuko „Leads“ (data, vardas, el. paštas, žinutė) naudodamas spreadsheets.values.append su valueInputOption RAW. Jei Google grąžina 429, bandyk dar kartą su eksponentiniu laukimu; jei vis tiek nepavyksta, palik potencialų klientą duomenų bazėje ir bandyk vėliau.

Dažniausios klaidos

• Pamiršti pasidalinti lentele su servisinės paskyros el. paštu. Tada API grąžina leidimo klaidą, nors raktas tinkamas.
• Raktas naršyklėje ar repozitorijoje. JSON raktas suteikia prieigą prie visų lentelių, kurios su juo bendrinamos. Žr. kaip saugoti API raktus.
• USER_ENTERED naudojimas naudotojų įvesčiai, o tai leidžia formulių injekciją.
• API kvietimas kiekvienai užklausai ir minutinės kvotos viršijimas pirmo srauto piko metu.
• Priklausymas nuo stulpelių pozicijų. Kas nors įterpia stulpelį, ir programa nuskaito neteisingus duomenis. Skaitykite antraštės eilutę ir susiekite pagal pavadinimą arba užrakinkite antraštę.
• Lentelės bendrinimas plačiau, nei reikia. „Bet kas, turintis nuorodą“ daro ją vieša.
• Lentelės naudojimas kaip kelių naudotojų duomenų bazės. Lygiagretūs rašymai ir trūkstamos teisės sukelia prarastus ar nutekėjusius duomenis.

Kontrolinis sąrašas

• Įjungtas Sheets API; sukurta servisinė paskyra
• Lentelė pasidalyta su servisinės paskyros el. paštu mažiausia reikalinga rolė
• Raktas ir lentelės ID saugomi kaip serverio pusės paslaptys
• Visi kvietimai atliekami iš serverio
• Intervaluose naudojami skirtukų pavadinimai
• Naudotojo tekstui naudojamas RAW
• Skaitymai talpinami į talpyklą; 429 tvarkomas su laukimu
• Programa sklandžiai veikia, jei Sheets nepasiekiamas
• Nuspręsta, kuri pusė yra tiesos šaltinis

Google Sheets Mythex platformoje

Mythex platformoje su Sheets galima dirbti dviem skirtingais būdais. Jungtys (connectors) susieja jūsų Google paskyrą su Mythex, kad agentas galėtų ją naudoti kurdamas, pavyzdžiui, nuskaityti lentelę ir pagal ją sukurti skydelį. Dokumentacijoje nurodoma, kad prisijungimo duomenys lieka Mythex jungčių paslaugoje ir niekada nepatenka į jūsų kodą (žr. Connectors; patvirtinkite kiekvieną leidimą, kurio paprašo Google). Kad paskelbta programa pati skaitytų ar rašytų lentelę, patikimas kelias yra šio vadovo: servisinės paskyros raktas, saugomas kaip projekto paslaptis, ir Sheets API kvietimai iš jūsų serverio, kaip aprašyta Integrate any API. Jei lentelė jau nebepakanka, paprašykite agento perkelti duomenis į projekto duomenų bazę ir pastatyti skydelį ant jos.

Klausimai