Hogyan kösd össze a Google Sheetst az appoddal

Google Sheets appba kötéséhez engedélyezed a Google Sheets API-t egy Google Cloud projektben, létrehozol egy szolgáltatásfiókot, megosztod a táblázatot a szolgáltatásfiók e-mail-címével, és a kulcsát szerveroldali titkosként tárolod. A szervered ezután a spreadsheets.values.get hívással olvas sorokat, a spreadsheets.values.append hívással pedig sorokat ad hozzá. Ha a felhasználóknak a saját táblázataikat kell csatlakoztatniuk, akkor OAuth-ot használj; ha a táblázat teljesen nyilvános, az olvasáshoz egyszerű API-kulcs is elég.

Ez az útmutató bemutatja, melyik módszer illik hozzád, a szükséges hívásokat, a kvótákat és a buktatókat, valamint promptokat egy AI-appépítőnek. A Google-adatok a Google fejlesztői dokumentációjából származnak, 2026 szeptemberi állapot szerint.

Miért kötnél össze egy táblázatot

Gyakori okok:

• A csapat munkafolyamatának megtartása. A munkatársak továbbra is a Sheetsben szerkesztik az árlistát vagy a beosztást; az app ezt mutatja.
• Adatgyűjtés ott, ahol az emberek úgyis néznek. Új regisztrációk, rendelések vagy űrlapválaszok sorokként érkeznek.
• Riportolás. Az app adatait táblázatba exportálod azoknak, akik táblázatokban élnek.
• Ugródeszka. Kezdd a táblázatból, majd lépj egy rendes adatbázisra. Lásd hogyan alakíts egy táblázatot appá.

Válaszd ki, hogyan jelentkezzen be az app a Google-be

A Google hitelesítési útmutatója három típust ír le:

A legtöbb appnál a szolgáltatásfiók a jó választás: egy hitelesítő adatkészlet, amely a tiéd, és csak azokhoz a táblázatokhoz fér hozzá, amelyeket kifejezetten megosztottál vele.

Lépésről lépésre szolgáltatásfiókkal

1. Hozz létre vagy válassz egy Google Cloud projektet, és engedélyezd a Google Sheets API-t.
2. Hozz létre egy szolgáltatásfiókot, és hozzá egy kulcsot. A kulcs egy JSON-fájl; kezeld úgy, mint a jelszót.
3. Oszd meg a táblázatot a szolgáltatásfiók e-mail-címével: Megtekintő jogosultsággal, ha csak olvasnod kell, vagy Szerkesztő jogosultsággal, ha írnod is. A Google útmutatója szerint ez a szokásos megosztási képernyőn történik.
4. Tárold a kulcsot titokként a szervereden, például GOOGLE_SERVICE_ACCOUNT_JSON néven, a táblázat azonosítóját (a hosszú karaktersorozatot a táblázat URL-jében) pedig SHEET_ID néven.
5. Hívd az API-t a szerverről a Google klienskönyvtárával a nyelvedhez.
6. Gyorsítótárazd az olvasásokat, ha sok látogató ugyanazt az adatot nézi, hogy ne érd el a kvótát.

A hívások, amelyeket használni fogsz

A Google olvasási és írási útmutatójából:

A tartományok A1-jelölést használnak. A Google megjegyzi, hogy a munkalap neve nélküli tartomány, például A1:B2, az első munkalapra vonatkozik, ezért nevezd meg a fület kifejezetten, hogy ne lepjen meg, ha valaki átrendezi a füleket.

RAW vs USER_ENTERED

Az írásokhoz kell egy valueInputOption:

• RAW pontosan azt tárolja, amit küldesz, szövegként. A =1+2 szövegként, =1+2 formában kerül be.
• USER_ENTERED úgy kezeli a bemenetet, mintha a Sheetsbe gépelték volna: a dátumokból dátum lesz, a =1+2-ből pedig képlet.

Ha az appodba a felhasználók által gépelt szöveget írsz, használd a RAW-t. USER_ENTERED módban valaki olyan képletet küldhet be, amely akkor fut le, amikor a kollégája megnyitja a táblázatot.

Kvóták és hibák

A Google Sheets API korlátainak oldala 2026 szeptemberi állapot szerint a következőket sorolja fel:

Nincs napi limit, amíg a percenkénti kvótákon belül maradsz. A túllépés 429: Too many requests hibát ad, a Google pedig csonkított exponenciális visszalépést (truncated exponential backoff) javasol: minden sikertelen próbálkozás után egyre hosszabb, véletlen késleltetéssel várj, egy maximumig. Az egyetlen kérés, amely 180 másodpercnél tovább tart, időtúllépést kap.

Gyakorlatban: ne hívd az API-t minden oldalmegjelenítéskor. A táblázat adatait gyorsítótárazd legalább egy percig, az olvasásokat kötegeld batchGet-tel, az írásokat pedig ahol lehet.

Lehetőségek és kompromisszumok

Nagyszámú felhasználónál vagy érzékeny adatoknál egy adatbázis a jobb igazságforrás. Lásd mi az adatbázis.

Promptok az AI-appépítődnek

Táblázat olvasása:

Jelenítsd meg a Google Sheet „Menu” fülének tartalmát a menü oldalon. Használd a Google Sheets API-t a szerverről, egy szolgáltatásfiókkal, amelynek JSON-kulcsa a GOOGLE_SERVICE_ACCOUNT_JSON titokban van, a táblázat azonosítója pedig a SHEET_ID-ban. Olvasd a Menu!A2:D tartományt (név, leírás, ár, kategória). Az eredményt tartsd gyorsítótárban 5 percig. Ha az API hibázik, az utoljára gyorsítótárazott verziót mutasd. A kulcsot soha ne küldd el a böngészőnek.

Sorok írása:

Amikor valaki elküldi a kapcsolatfelvételi űrlapot, mentsd az adatbázisba, és a „Leads” fülhöz is fűzz egy sort (dátum, név, e-mail, üzenet) a spreadsheets.values.append hívással, valueInputOption RAW-val. Ha a Google 429-et ad, próbáld újra exponenciális visszalépéssel; ha még így is hibázik, tartsd meg a lead-et az adatbázisban, és próbáld később újra.

Gyakori hibák

• A táblázat megosztásának elfelejtése a szolgáltatásfiók e-mail-címével. Az API ilyenkor jogosultsági hibát ad, pedig a kulcs rendben van.
• A kulcs a frontenden vagy a repóban. A JSON-kulcs minden olyan táblázathoz hozzáférést ad, amely megosztva van vele. Lásd hogyan őrizd meg biztonságban az API-kulcsaidat.
• USER_ENTERED használata felhasználói bemenethez, ami képletbeszúrást tesz lehetővé.
• Az API hívása minden kérésnél, és a percenkénti kvóta elérése az első forgalmi csúcsnál.
• Oszloppozíciókra való támaszkodás. Valaki beszúr egy oszlopot, és az app rossz adatot olvas. Olvasd a fejléc sort, és név szerint térképezd, vagy zárd le a fejlécet.
• A táblázat szélesebb körű megosztása, mint kellene. A „Bárkinek, akinek a linkje van” nyilvánossá teszi.
• A táblázat többfelhasználós adatbázisként való használata. Az egyidejű írások és a hiányzó jogosultságok adatvesztéshez vagy adatszivárgáshoz vezetnek.

Ellenőrzőlista

• Sheets API engedélyezve; szolgáltatásfiók létrehozva
• A táblázat megosztva a szolgáltatásfiók e-mail-címével a szükséges legkisebb szereppel
• A kulcs és a táblázat azonosítója szerveroldali titokként tárolva
• Minden hívás a szerverről történik
• A tartományokban fülneveket használsz
• A felhasználók által megadott szöveghez RAW van használva
• Az olvasások gyorsítótárazva; a 429 visszalépéssel kezelve
• Az app elegánsan kezeli, ha a Sheets nem elérhető
• Eldöntötted, melyik oldal az igazságforrás

Google Sheets a Mythexben

A Mythexnek két különböző módja van a Sheetsszel való munkára. A csatlakozók összekötik a Google-fiókodat a Mythexszel, hogy az ügynök építés közben használhassa, például egy táblázat beolvasására egy abból épített dashboardhoz; a dokumentáció szerint a hitelesítő adat a Mythex kapcsolati szolgáltatásánál marad, és soha nem kerül a kódodba (lásd Csatlakozók, és hagyd jóvá, amit a Google kér). A publikált app önálló olvasásához vagy íráshoz a megbízható út az, amit ez az útmutató ír le: szolgáltatásfiók-kulcs projekt-titokként, és a Sheets API hívások a szerveredről, ahogy az Integrate any API leírja. Ha kinövöd a táblázatot, kérd meg az ügynököt, hogy az adatokat költöztesse a projekt adatbázisába, és építs rá dashboardot.

Kérdések