Kā savienot Google Sheets ar savu lietotni

Lai savienotu Google Sheets ar lietotni, iespējojiet Google Sheets API Google Cloud projektā, izveidojiet servisa kontu, kopīgojiet tabulu ar servisa konta e-pasta adresi un glabājiet tā atslēgu kā servera puses noslēpumu. Pēc tam jūsu serveris rindas lasa ar spreadsheets.values.get un pievieno ar spreadsheets.values.append. Ja lietotājiem jāsavieno savas tabulas, izmantojiet OAuth, un, ja tabula ir pilnībā publiska, lasīšanai pietiek vienkāršas API atslēgas.

Šis ceļvedis aptver to, kura metode der, vajadzīgos izsaukumus, kvotas un nepilnības, kā arī uzvednes AI lietotņu veidotājam. Google informācija ir no Google izstrādātāju dokumentācijas 2026. gada septembrī.

Kāpēc vispār savienot tabulu

Biežākie iemesli:

• Saglabāt komandas darba plūsmu. Darbinieki turpina rediģēt cenrādi vai grafiku Sheets; lietotne to rāda.
• Savākt datus vietā, kur cilvēki jau skatās. Jaunās reģistrācijas, pasūtījumi vai formu atbildes nonāk kā rindas.
• Pārskati. Eksportēt lietotnes datus uz tabulu cilvēkiem, kas dzīvo izklājlapās.
• Pakāpiens. Sākt no tabulas, pēc tam pāriet uz īstu datubāzi. Skatiet kā pārvērst izklājlapu par lietotni.

Izvēlieties, kā jūsu lietotne pierakstās Google

Google akreditācijas rokasgrāmata apraksta trīs veidus:

Vairumam lietotņu pareizā izvēle ir servisa konts: viena akreditāciju kopa, kas pieder jums, ar piekļuvi tikai tām tabulām, kuras skaidri kopīgojat ar to.

Soli pa solim ar servisa kontu

1. Izveidojiet vai izvēlieties Google Cloud projektu un iespējojiet Google Sheets API.
2. Izveidojiet servisa kontu un tam atslēgu. Atslēga ir JSON fails; apejieties ar to kā ar paroli.
3. Kopīgojiet tabulu ar servisa konta e-pasta adresi kā Viewer lasīšanai vai Editor rakstīšanai. Google rokasgrāmata saka, ka to dara parastajā kopīgošanas ekrānā.
4. Glabājiet atslēgu kā noslēpumu savā serverī, piemēram, GOOGLE_SERVICE_ACCOUNT_JSON, un tabulas ID (garo virkni tabulas URL) kā SHEET_ID.
5. Izsauciet API no servera ar Google klienta bibliotēku savai valodai.
6. Keširojiet lasījumus, ja daudzi apmeklētāji redz tos pašus datus, lai nesasniegtu kvotu.

Izsaukumi, ko izmantosiet

No Google ceļveža par vērtību lasīšanu un rakstīšanu:

Diapazoni tiek rakstīti A1 notācijā. Google norāda, ka diapazons bez lapas nosaukuma, piemēram, A1:B2, attiecas uz pirmo lapu, tāpēc nosauciet cilni skaidri, lai nebūtu pārsteigumu, kad kāds pārkārto cilnes.

RAW pret USER_ENTERED

Rakstīšanai vajag valueInputOption:

• RAW saglabā tieši to, ko nosūtāt, kā tekstu. =1+2 tiek saglabāts kā teksts =1+2.
• USER_ENTERED apstrādā ievadi tā, it kā to ierakstītu Sheets: datumi kļūst par datumiem, un =1+2 kļūst par formulu.

Ja rakstāt tekstu, ko lietotāji ievadīja jūsu lietotnē, izmantojiet RAW. Ar USER_ENTERED kāds var iesniegt formulu, kas izpildās, kad kolēģis atver tabulu.

Kvotas un kļūdas

1. gada septembrī Google Sheets API ierobežojumu lapa norāda:

Dienas limita nav, ja paliekat minūtes kvotās. Pārsniedzot tās, atgriežas 429: Too many requests, un Google iesaka pakāpenisku eksponenciālu atkāpšanos (truncated exponential backoff): katrs neveiksmīgs mēģinājums gaidiet ilgāk, ar nejaušu aizkavi, līdz noteiktam maksimumam. Viens pieprasījums, kas ilgst vairāk nekā 180 sekundes, beidzas ar taimautu.

Praksē: nezvaniet API katrā lapas skatījumā. Keširojiet tabulas datus vismaz minūti, apvienojiet lasījumus ar batchGet un, kur iespējams, apvienojiet rakstīšanu.

Iespējas un kompromisi

Jebkam ar daudziem lietotājiem vai sensitīviem datiem datubāze ir labāks patiesības avots. Skatiet kas ir datubāze.

Uzvednes AI lietotņu veidotājam

Tabulas lasīšana:

Parādi mūsu Google Sheets tabulas cilni „Menu” ēdienkartes lapā. Izmanto Google Sheets API no servera ar servisa kontu, kura JSON atslēga ir noslēpumā GOOGLE_SERVICE_ACCOUNT_JSON, un tabulas ID ir SHEET_ID. Nolasi diapazonu Menu!A2:D (nosaukums, apraksts, cena, kategorija). Keširo rezultātu 5 minūtes. Ja API neizdodas, parādi pēdējo keširoto versiju. Nekad nesūti atslēgu pārlūkam.

Rindu rakstīšana:

Kad kāds iesniedz kontaktformu, saglabā to mūsu datubāzē un arī pievieno rindu cilnei „Leads” (datums, vārds, e-pasts, ziņojums), izmantojot spreadsheets.values.append ar valueInputOption RAW. Ja Google atgriež 429, mēģini vēlreiz ar eksponenciālu atkāpšanos; ja joprojām neizdodas, paturi potenciālo klientu datubāzē un mēģini vēlāk.

Biežākās kļūdas

• Aizmirst kopīgot tabulu ar servisa konta e-pastu. API tad atgriež atļauju kļūdu, lai gan atslēga ir pareiza.
• Atslēga frontend pusē vai repozitorijā. JSON atslēga piešķir piekļuvi visām tabulām, kas ar to kopīgotas. Skatiet kā sargāt API atslēgas.
• USER_ENTERED lietotāju ievadei, kas ļauj formulu ievadi.
• API izsaukums katrā pieprasījumā un kvotas sasniegšana pirmajā trafika kāpumā.
• Paļaušanās uz kolonnu pozīcijām. Kāds ievieto kolonnu, un lietotne nolasa nepareizus datus. Lasiet galvenes rindu un kartējiet pēc nosaukuma vai aizslēdziet galveni.
• Tabulas kopīgošana plašāk nekā vajadzīgs. „Anyone with the link” padara to publisku.
• Tabula kā daudzlietotāju datubāze. Vienlaicīgi ieraksti un trūkstošas tiesības izraisa zaudētus vai noplūdušus datus.

Kontrolsaraksts

• Sheets API iespējots; servisa konts izveidots
• Tabula kopīgota ar servisa konta e-pastu ar zemāko nepieciešamo lomu
• Atslēga un tabulas ID glabāti kā servera puses noslēpumi
• Visi izsaukumi veikti no servera
• Cilņu nosaukumi izmantoti diapazonos
• RAW izmantots lietotāja ievadītam tekstam
• Lasījumi keširoti; 429 apstrādāts ar atkāpšanos
• Lietotne grāciozi darbojas, ja Sheets nav pieejams
• Izlemts, kurš pusē ir patiesības avots

Google Sheets Mythex

Mythex ir divi dažādi veidi, kā strādāt ar Sheets. Connectors savieno jūsu Google kontu ar Mythex, lai aģents to varētu izmantot, kamēr veidojat, piemēram, nolasīt tabulu, lai uzbūvētu no tās paneli. Dokumentācijā teikts, ka akreditācija paliek pie Mythex savienojumu pakalpojuma un nekad nenonāk jūsu kodā (skatiet Connectors, un apstipriniet katru atļauju, ko prasa Google). Lai publicētā lietotne pati varētu lasīt vai rakstīt tabulu, uzticamākais ceļš ir tas, kas aprakstīts šajā ceļvedī: servisa konta atslēga kā projekta noslēpums un Sheets API izsaukumi no servera, kā Integrate any API aprakstā. Ja izaugat no tabulas, lūdziet aģentam pārcelt datus uz projekta datubāzi un izveidot paneli uz tās.

Jautājumi