Hvernig á að tengja Google Sheets við appið þitt

Til að tengja Google Sheets við appið þitt virkjarðu Google Sheets API í Google Cloud-verkefni, býrð til þjónustureikning, deilir töflureikninum með netfangi þjónustureikningsins og geymir lykilinn hans sem leyndarmál á þjóninum. Þjónninn þinn les línur með spreadsheets.values.get og bætir við línum með spreadsheets.values.append. Ef notendur þurfa að tengja sína eigin töflureikna notarðu OAuth í staðinn, og ef töflureikninn er alveg opinber nægir einfaldur API-lykill til að lesa.

Þessi leiðbeining fer yfir hvaða aðferð hentar, köllin sem þú þarft, kvótana og gildrurnar, og fyrirmæli fyrir gervigreindarsmíðatól. Upplýsingar um Google eru úr þróunarskjölum Google frá september 2026.

Af hverju tengja töflureikni yfirleitt

Algengar ástæður:

• Halda vinnuflæði teymisins. Starfsfólk heldur áfram að breyta verðlista eða vaktaáætlun í Sheets; appið sýnir hana.
• Safna gögnum þar sem fólk er þegar. Nýjar skráningar, pantanir eða svör úr formum lenda sem línur.
• Skýrslugerð. Flytja gögn úr appinu út í töflureikni fyrir fólk sem vinnur í töflureiknum.
• Stökkpallur. Byrjaðu á töflureikninum og færðu þig síðan yfir í alvöru gagnagrunn. Sjá hvernig á að breyta töflureikni í app.

Veldu hvernig appið auðkennir sig hjá Google

Leiðbeiningar Google um auðkenningu lýsa þremur gerðum:

Fyrir flest öpp er þjónustureikningur rétti kosturinn: eitt sett af auðkenni, í þinni eigu, með aðgang aðeins að þeim töflureiknum sem þú deilir sérstaklega með honum.

Skref fyrir skref með þjónustureikningi

1. Búðu til eða veldu Google Cloud-verkefni og virkjaðu Google Sheets API.
2. Búðu til þjónustureikning og lykil fyrir hann. Lykillinn er JSON-skrá; meðhöndlaðu hana eins og lykilorð.
3. Deildu töflureikninum með netfangi þjónustureikningsins, sem Viewer til að lesa eingöngu eða Editor til að skrifa. Leiðbeiningar Google segja að þetta sé gert í venjulega deiliglugganum.
4. Geymdu lykilinn sem leyndarmál á þjóninum, til dæmis GOOGLE_SERVICE_ACCOUNT_JSON, ásamt auðkenni töflureikningsins (langa strengnum í slóð töflunnar) sem SHEET_ID.
5. Kallaðu á API-ið frá þjóninum með bókasafni Google fyrir þitt forritunarmál.
6. Geymdu lestra í skyndiminni ef margir gestir sjá sömu gögnin, svo þú lendir ekki á kvótanum.

Köllin sem þú notar

Úr leiðbeiningum Google um lestur og skrif gilda:

Svið nota A1-skrift. Google bendir á að svið án heiti blaðs, eins og A1:B2, gildi um fyrsta blaðið, svo nefndu flipann skýrt til að forðast óvart þegar einhver raðar flipunum upp á nýtt.

RAW á móti USER_ENTERED

Skrifanir þurfa valueInputOption:

• RAW geymir nákvæmlega það sem þú sendir, sem texta. =1+2 er geymt sem textinn =1+2.
• USER_ENTERED meðhöndlar innslátt eins og þegar slegið er inn í Sheets: dagsetningar verða dagsetningar og =1+2 verður formúla.

Ef þú skrifar texta sem notendur slógu inn í appið þitt skaltu nota RAW. Með USER_ENTERED gæti einhver sent inn formúlu sem keyrir þegar samstarfsmaður opnar töflureikninn.

Kvótar og villur

Frá og með september 2026 listar síða Google um takmörk Sheets API:

Það er ekkert daglegt takmark svo lengi sem þú heldur þér innan mínútukvótanna. Ef þú ferð yfir þá færðu 429: Too many requests, og Google mælir með styttri veldisbundinni bið (truncated exponential backoff): bíddu lengur eftir hverja misheppnaða tilraun, með slembibið, upp að hámarki. Ein beiðni sem tekur yfir 180 sekúndur rennur út.

Í reynd: ekki kalla á API-ið í hvert sinn sem síða er skoðuð. Geymdu gögn töflunnar í skyndiminni í að minnsta kosti mínútu, sameinaðu lestra með batchGet, og sameinaðu skrifanir þar sem hægt er.

Valkostir og málamiðlanir

Fyrir allt með marga notendur eða viðkvæm gögn er gagnagrunnur betri uppspretta sannleikans. Sjá hvað gagnagrunnur er.

Fyrirmæli til gervigreindarsmíðatólsins þíns

Að lesa töflu:

Sýndu flipann „Menu“ úr Google-töflureikninum okkar á matseðilsíðunni. Notaðu Google Sheets API frá þjóninum með þjónustureikningi þar sem JSON-lykillinn er í leyndarmálinu GOOGLE_SERVICE_ACCOUNT_JSON og auðkenni töflunnar í SHEET_ID. Lestu sviðið Menu!A2:D (heiti, lýsing, verð, flokkur). Geymdu niðurstöðuna í skyndiminni í 5 mínútur. Ef API-ið mistekst skaltu sýna síðustu útgáfuna sem var í skyndiminni. Sendu lykilinn aldrei í vafrann.

Að skrifa línur:

Þegar einhver sendir tengiliðsformið skaltu vista það í gagnagrunninum okkar og jafnframt bæta línu við flipann „Leads“ (dagsetning, nafn, netfang, skilaboð) með spreadsheets.values.append og valueInputOption RAW. Ef Google skilar 429 skaltu reyna aftur með veldisbundinni bið; ef það mistekst enn skaltu geyma ábendinguna í gagnagrunninum og reyna síðar.

Algeng mistök

• Að gleyma að deila töflunni með netfangi þjónustureikningsins. API-ið skilar þá heimildavillu þótt lykillinn sé í lagi.
• Lykill í framenda eða í kóðageymslunni. JSON-lykillinn veitir aðgang að öllum töflum sem deilt er með honum. Sjá hvernig á að halda API-lyklum öruggum.
• Að nota USER_ENTERED fyrir innslátt notenda, sem leyfir innspýtingu formúla.
• Að kalla á API-ið í hverri beiðni og lenda á mínútukvótanum við fyrsta umferðarkipp.
• Að treysta á staðsetningu dálka. Einhver setur inn dálk og appið les rangt gögn. Lestu hausröðina og paraðu eftir heiti, eða læstu hausnum.
• Að deila töflunni víðar en þarf. „Allir sem hafa hlekkinn“ gerir hana opinbera.
• Að nota töflu sem gagnagrunn fyrir marga notendur. Samtímaskrifanir og vantandi heimildir valda töpuðum eða lekum gögnum.

Gátlisti

• Sheets API virkjað; þjónustureikningur búinn til
• Tafla deilt með netfangi þjónustureikningsins með lægsta hlutverki sem þarf
• Lykill og auðkenni töflu geymt sem leyndarmál á þjóninum
• Öll köll gerð frá þjóninum
• Heiti flipa notuð í sviðum
• RAW notað fyrir texta frá notendum
• Lestrar geymdir í skyndiminni; 429 meðhöndlað með bið
• Appið ræður við það ef Sheets er ekki tiltækt
• Ákveðið hvor hliðin er uppspretta sannleikans

Google Sheets í Mythex

Mythex hefur tvær aðskildar leiðir til að vinna með Sheets. Tengingar (connectors) tengja Google-reikninginn þinn við Mythex svo agentinn geti notað hann á meðan þú smíðar, til dæmis til að lesa töflu og byggja mælaborð úr henni. Skjölin segja að auðkenningin sé áfram hjá tengiþjónustu Mythex og lendi aldrei í kóðanum þínum (sjá Tengingar, og samþykktu hverja heimild sem Google biður um). Fyrir birt appið til að lesa eða skrifa í töflu af sjálfu sér er áreiðanlegasta leiðin sú sem lýst er í þessari leiðbeiningu: þjónustureikningslykill geymdur sem leyndarmál verkefnisins og Sheets API-köll frá þjóninum þínum, eins og í Tengja hvaða API sem er. Ef þú ert að vaxa upp úr töflunni skaltu biðja agentinn að færa gögnin í gagnagrunn verkefnisins og byggja mælaborð ofan á hann.

Spurningar