Slik kobler du Google Sheets til appen din

For å koble Google Sheets til appen din aktiverer du Google Sheets API i et Google Cloud-prosjekt, oppretter en tjenestekonto, deler regnearket med tjenestekontoens e-postadresse, og lagrer nøkkelen som en hemmelighet på serveren. Serveren leser rader med spreadsheets.values.get og legger til rader med spreadsheets.values.append. Hvis brukerne må koble til sine egne regneark, bruker du OAuth i stedet, og hvis regnearket er helt offentlig, er en enkel API-nøkkel nok for lesing.

Denne guiden dekker hvilken metode som passer, kallene du trenger, kvoter og fallgruver, og prompter for en KI-app-bygger. Google-detaljene er hentet fra Googles utviklerdokumentasjon per september 2026.

Hvorfor koble til et regneark i det hele tatt

Vanlige grunner:

• Behold arbeidsflyten til teamet. Ansatte fortsetter å redigere en prisliste eller plan i Sheets; appen viser den.
• Samle inn data der folk allerede ser. Nye registreringer, bestillinger eller skjemasvar havner som rader.
• Rapportering. Eksporter appdata til et regneark for folk som jobber i regneark til daglig.
• Et steg på veien. Start fra regnearket, og gå så over til en skikkelig database. Se slik gjør du et regneark om til en app.

Velg hvordan appen din logger inn hos Google

Googles veiledning for legitimasjon beskriver tre typer:

For de fleste apper er en tjenestekonto det riktige valget: ett sett med legitimasjon, eid av deg, med tilgang bare til regnearkene du uttrykkelig deler med den.

Steg for steg med en tjenestekonto

1. Opprett eller velg et Google Cloud-prosjekt og aktiver Google Sheets API.
2. Opprett en tjenestekonto og en nøkkel for den. Nøkkelen er en JSON-fil; behandle den som et passord.
3. Del regnearket med tjenestekontoens e-postadresse, som Viewer for skrivebeskyttet tilgang eller Editor for å skrive. Googles veiledning sier at dette gjøres via vanlig delingsskjerm.
4. Lagre nøkkelen som en hemmelighet på serveren, for eksempel GOOGLE_SERVICE_ACCOUNT_JSON, pluss regnearkets ID (den lange strengen i regnearkets URL) som SHEET_ID.
5. Kall API-et fra serveren med Googles klientbibliotek for ditt språk.
6. Cache lesinger hvis mange besøkende ser de samme dataene, slik at du ikke treffer kvoten.

Kallene du bruker

Fra Googles veiledning for å lese og skrive verdier:

Områder bruker A1-notasjon. Google påpeker at et område uten arknavn, som A1:B2, gjelder for det første arket, så navngi fanen eksplisitt for å unngå overraskelser når noen flytter fanene.

RAW mot USER_ENTERED

Skrivinger trenger en valueInputOption:

• RAW lagrer nøyaktig det du sender, som tekst. =1+2 lagres som teksten =1+2.
• USER_ENTERED behandler innholdet som om det var skrevet inn i Sheets: datoer blir datoer, og =1+2 blir en formel.

Hvis du skriver tekst som brukere har skrevet i appen din, bruk RAW. Med USER_ENTERED kan noen sende inn en formel som kjører når en kollega åpner regnearket.

Kvoter og feil

Per september 2026 viser Googles side for grenser for Sheets API:

Det finnes ingen døgngrense så lenge du holder deg innenfor minuttkvotene. Overskrider du dem, får du 429: Too many requests, og Google anbefaler avkortet eksponentiell backoff: vent lenger etter hvert mislykket forsøk, med en tilfeldig forsinkelse, opp til et maksimum. En enkelt forespørsel som tar over 180 sekunder får tidsavbrudd.

I praksis: ikke kall API-et ved hver sidevisning. Cache regnearkdataene i minst et minutt, bruk batchGet for å samle lesinger, og samle skrivinger der du kan.

Alternativer og avveininger

For alt med mange brukere eller sensitive data er en database den bedre kilden til sannhet. Se hva en database er.

Prompter til KI-byggeren din

Lese et regneark:

Vis fanen «Meny» i Google-regnearket vårt på menysiden. Bruk Google Sheets API fra serveren med en tjenestekonto hvis JSON-nøkkel ligger i hemmeligheten GOOGLE_SERVICE_ACCOUNT_JSON, og regnearkets ID i SHEET_ID. Les området Meny!A2:D (navn, beskrivelse, pris, kategori). Cache resultatet i 5 minutter. Hvis API-et feiler, vis den sist cachede versjonen. Send aldri nøkkelen til nettleseren.

Skrive rader:

Når noen sender inn kontaktskjemaet, lagre det i databasen vår og legg også til en rad i fanen «Leads» (dato, navn, e-post, melding) med spreadsheets.values.append og valueInputOption RAW. Hvis Google svarer med 429, prøv på nytt med eksponentiell backoff; hvis det fortsatt feiler, behold leaden i databasen og prøv igjen senere.

Vanlige feil

• Å glemme å dele regnearket med tjenestekontoens e-post. API-et svarer da med en tillatelsesfeil, selv om nøkkelen er riktig.
• Nøkkel i frontend eller i repositoriet. JSON-nøkkelen gir tilgang til alle regneark som er delt med den. Se slik holder du API-nøkler trygge.
• Å bruke USER_ENTERED for brukerinnhold, som tillater formelinjeksjon.
• Å kalle API-et ved hver forespørsel og treffe minuttkvoten ved den første trafikktoppen.
• Å stole på kolonneposisjoner. Noen setter inn en kolonne, og appen leser feil data. Les overskriftsraden og map etter navn, eller lås overskriften.
• Å dele regnearket bredere enn nødvendig. «Alle med lenken» gjør det offentlig.
• Å bruke et regneark som en flerbrukerdatabase. Samtidige skrivinger og manglende tillatelser gir tapte eller lekkede data.

Sjekkliste

• Sheets API aktivert; tjenestekonto opprettet
• Regnearket delt med tjenestekontoens e-post med lavest nødvendige rolle
• Nøkkel og regnearkets ID lagret som hemmeligheter på serveren
• Alle kall gjort fra serveren
• Fanenavn brukt i områder
• RAW brukt for brukerlevert tekst
• Lesinger cachet; 429 håndtert med backoff
• Appen degraderer pent hvis Sheets er utilgjengelig
• Bestemt hvilken side som er kilden til sannhet

Google Sheets i Mythex

Mythex har to ulike måter å jobbe med Sheets på. Koblinger kobler Google-kontoen din til Mythex, slik at agenten kan bruke den mens du bygger, for eksempel å lese et regneark og lage et dashbord fra det. Dokumentasjonen sier at legitimasjonen blir værende hos Mythex sin tilkoblingstjeneste og aldri havner i koden din (se Koblinger, og godkjenn hver tillatelse Google ber om). For at den publiserte appen skal lese eller skrive til et regneark på egen hånd, er den pålitelige veien den i denne guiden: en tjenestekontonøkkel lagret som en prosjekthemmelighet, og Sheets API-kall fra serveren din, slik som i Integrer ethvert API. Hvis du vokser ut av regnearket, be agenten flytte dataene til prosjektets database og bygge et dashbord på toppen av dem.

Spørsmål