Како да поврзете Google Sheets со вашата апликација

За да поврзете Google Sheets со вашата апликација, овозможете го Google Sheets API во Google Cloud проект, создајте service account, споделете ја табелата со е-адресата на service account-от и чувајте го неговиот клуч како серверска тајна. Вашиот сервер потоа ги чита редовите со spreadsheets.values.get и додава редови со spreadsheets.values.append. Ако корисниците треба да ги поврзат своите табели, користете OAuth; а ако табелата е целосно јавна, за читање е доволен едноставен API клуч.

Овој водич го опфаќа кој метод одговара, повиците што ви требаат, квотите и замките. Деталите за Google се од документацијата на Google за programери, од септември 2026.

Зошто воопшто да поврзувате табела

Чести причини:

• Задржување на работниот тек на тимот. Персоналот и понатаму уредува ценовник или распоред во Sheets; апликацијата го прикажува.
• Собирање податоци таму каде луѓето и така гледаат. Нови регистрации, нарачки или одговори од формулари стигнуваат како редови.
• Извештаи. Извезувајте податоци од апликацијата во табела за луѓе што живеат во табелите.
• Скалило кон поголемо. Почнете од табелата, па преминете на вистинска база. Видете како да претворите табела во апликација.

Изберете како вашата апликација се најавува кај Google

Водичот за креденцијали на Google опишува три типа:

За повеќето апликации, service account е правилниот избор: еден сет креденцијали, во ваша сопственост, со пристап само до табелите што изречно ќе ги споделите со него.

Чекор по чекор со service account

1. Создајте или изберете Google Cloud проект и овозможете Google Sheets API.
2. Создајте service account и клуч за него. Клучот е JSON датотека; третирајте ја како лозинка.
3. Споделете ја табелата со е-адресата на service account-от, како Viewer за читање или Editor за пишување. Водичот на Google вели дека тоа се прави преку вообичаениот екран за споделување.
4. Чувајте го клучот како тајна на вашиот сервер, на пример GOOGLE_SERVICE_ACCOUNT_JSON, плус ID-то на табелата (долгиот низ во URL-то на табелата) како SHEET_ID.
5. Повикувајте го API од серверот со клиентската библиотека на Google за вашиот јазик.
6. Кеширајте ги читањата ако многу посетители ги гледаат истите податоци, за да не ја достигнувате квотата.

Повиците што ќе ги користите

Од водичот на Google за читање и запишување вредности:

Опсезите користат A1 нотација. Google напоменува дека опсег без име на листот, како A1:B2, се применува на првиот лист, па именувајте го листот експлицитно за да избегнете изненадувања кога некој ќе ги прередува листовите.

RAW наспроти USER_ENTERED

Запишувањата бараат valueInputOption:

• RAW го зачувува точно она што го испраќате, како текст. =1+2 се зачувува како текст =1+2.
• USER_ENTERED влезот го третира како да е впишан во Sheets: датумите стануваат датуми, а =1+2 станува формула.

Ако запишувате текст што корисниците го внеле во вашата апликација, користете RAW. Со USER_ENTERED, некој може да испрати формула што ќе се изврши кога колегата ќе ја отвори табелата.

Квоти и грешки

Од септември 2026, страницата за ограничувања на Sheets API на Google наведува:

Нема дневно ограничување сè додека сте во рамките на минутните квоти. Ако ги надминете, се враќа 429: Too many requests, а Google препорачува truncated exponential backoff: чекајте сè подолго по секој неуспешен обид, со случајно доцнење, до одреден максимум. Едно барање што трае над 180 секунди истекува.

Во пракса: не повикувајте го API при секое отворање на страница. Кеширајте ги податоците на табелата една минута или повеќе, групирајте ги читањата со batchGet и групирајте ги запишувањата кога можете.

Опции и компромиси

За сè со многу корисници или чувствителни податоци, базата е подобар извор на вистина. Видете што е база на податоци.

Промпти за вашиот AI градител

Читање на табела:

Прикажи го листот „Menu“ од нашата Google табела на страницата со менито. Користи Google Sheets API од серверот со service account чиј JSON клуч е во тајната GOOGLE_SERVICE_ACCOUNT_JSON, а ID-то на табелата е во SHEET_ID. Прочитај го опсегот Menu!A2:D (име, опис, цена, категорија). Кеширај го резултатот 5 минути. Ако API-то падне, прикажи ја последната кеширана верзија. Никогаш не го испраќај клучот до прелистувачот.

Запишување редови:

Кога некој ќе го испрати контакт формуларот, зачувај го во нашата база на податоци и додај ред во листот „Leads“ (датум, име, е-пошта, порака) со spreadsheets.values.append со valueInputOption RAW. Ако Google врати 429, обиди се повторно со exponential backoff; ако и понатаму не успева, задржи го потенцијалниот клиент во базата и обиди се подоцна.

Чести грешки

• Заборавање да се сподели табелата со е-адресата на service account-от. API-то тогаш враќа грешка за дозвола, иако клучот е во ред.
• Клучот во фронтенд или во репозиториумот. JSON клучот дава пристап до секоја табела споделена со него. Видете како да ги чувате API клучевите безбедни.
• Користење на USER_ENTERED за внес од корисници, што дозволува инјектирање формули.
• Повикување на API при секое барање и достигнување на минутната квота при првиот скок на сообраќај.
• Потпирање на позициите на колоните. Некој вметне колона и апликацијата чита погрешни податоци. Прочитајте го редот со заглавија и мапирајте по име, или заклучете ги заглавијата.
• Споделување на табелата пошироко отколку што треба. „Anyone with the link“ ја прави јавна.
• Користење табела како база за повеќе корисници. Истовремени запишувања и недостасувачки дозволи предизвикуваат загубени или протечени податоци.

Листа за проверка

• Sheets API овозможен; service account создаден
• Табелата споделена со е-адресата на service account-от со најниска потребна улога
• Клучот и ID-то на табелата се чуваат како серверски тајни
• Сите повици се направени од серверот
• Имињата на листовите се користат во опсезите
• RAW се користи за текст што го внесуваат корисниците
• Читањата се кеширани; 429 се обработува со backoff
• Апликацијата функционира graceful ако Sheets не е достапен
• Одлучено која страна е извор на вистина

Google Sheets во Mythex

Mythex има два различни начини за работа со Sheets. Конектори го поврзуваат вашиот Google налог со Mythex, така што агентот може да го користи додека градите, на пример за читање табела и градење табла врз неа; документацијата вели дека акредитивот останува кај услугата за поврзување на Mythex и никогаш не завршува во вашиот код (видете Конектори, и одобрете секоја дозвола што ја бара Google). За објавената апликација сама да чита или пишува во табела, поуздан е начинот од овој водич: service account клуч чуван како тајна на проектот и повици до Sheets API од вашиот сервер, како во Integrate any API. Ако ја надминувате табелата, замолете го агентот да ги премести податоците во базата на проектот и да изгради табла врз неа.

Прашања