Google Sheets-ті қолданбаңызға қалай қосу керек

Google Sheets-ті қолданбаңызға қосу үшін Google Cloud жобасында Google Sheets API-ді қосыңыз, сервис аккаунтын жасаңыз, электрондық кестені сервис аккаунтының поштасымен бөлісіңіз және оның кілтін серверлік құпия ретінде сақтаңыз. Содан кейін сервер spreadsheets.values.get арқылы жолдарды оқиды және spreadsheets.values.append арқылы жол қосады. Егер пайдаланушылар өз кестелерін қосқысы келсе, OAuth қолданыңыз, ал кесте толық ашық болса, оқу үшін қарапайым API кілті жеткілікті.

Бұл нұсқаулық қай әдіс сәйкес келетінін, қажетті шақырулар мен квоталарды, сондай-ақ AI қолданба жасағышқа арналған сұраныстарды қамтиды. Google мәліметтері 2026 жылдың қыркүйегіндегі Google әзірлеуші құжаттамасынан алынған.

Неге кестені қосу керек

Жиі кездесетін себептер:

• Команданың жұмыс үрдісін сақтау. Қызметкерлер баға тізімін немесе кестені Sheets-те өңдеуін жалғастырады; қолданба соны көрсетеді.
• Деректерді адамдар әлдеқашан қарайтын жерде жинау. Жаңа тіркелулер, тапсырыстар немесе форма жауаптары жолдар ретінде түседі.
• Есеп беру. Қолданба деректерін электрондық кестемен жұмыс істейтін адамдарға экспорттау.
• Секіріс тақтасы. Кестеден бастап, содан кейін толық дерекқорға көшу. Қараңыз: электрондық кестені қолданбаға қалай айналдыру керек.

Қолданбаңыз Google-ға қалай кіретінін таңдаңыз

Google-дің credentials нұсқаулығы үш түрді сипаттайды:

Көп қолданба үшін сервис аккаунты дұрыс таңдау: сіз иелік ететін бір credential жинағы, ол тек оған нақты бөліскен кестелерге қатынайды.

Сервис аккаунтымен қадам-қадам

1. Google Cloud жобасын жасаңыз немесе таңдаңыз және Google Sheets API-ді қосыңыз.
2. Сервис аккаунтын және оның кілтін жасаңыз. Кілт — JSON файлы; оны құпия сөздей сақтаңыз.
3. Электрондық кестені сервис аккаунтының поштасымен бөлісіңіз: тек оқу үшін 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 жылдың қыркүйегіндегі жағдай бойынша Google-дің Sheets API шектеулері беті мыналарды көрсетеді:

Минуттық квоталардың ішінде болсаңыз, күнделікті шек жоқ. Шектен асса, 429: Too many requests қайтады, ал Google кесілген экспоненциалды кідірісті (backoff) ұсынады: әр сәтсіз әрекеттен кейін ұзағырақ күтіңіз, кездейсоқ кідіріспен, максимумға дейін. Бір сұраныс 180 секундтан асып кетсе, уақыты бітеді.

Іс жүзінде: API-ді әр бет көрсетілімінде шақырмаңыз. Кесте деректерін бір минут немесе одан көп кэштеңіз, оқуларды batchGet арқылы топтаңыз, ал мүмкін болса жазуларды да топтаңыз.

Таңдаулар мен айырбастар

Көп пайдаланушысы бар немесе құпия деректері бар кез келген нәрсе үшін дерекқор — сенімдірек шынайы дерек көзі. Қараңыз: дерекқор дегеніміз не.

AI құрастырушыға берілетін сұраныстар

Кестені оқу:

Google Sheets кестеміздің "Menu" қойындысын мәзір бетінде көрсетіңіз. Google Sheets API-ді серверден пайдаланыңыз, сервис аккаунтымен, оның JSON кілті GOOGLE_SERVICE_ACCOUNT_JSON құпиясында, ал кесте ID-і SHEET_ID-де. Menu!A2:D диапазонын оқыңыз (атауы, сипаттамасы, бағасы, санаты). Нәтижені 5 минут кэштеңіз. API қате берсе, соңғы кэштелген нұсқаны көрсетіңіз. Кілтті ешқашан браузерге жібермеңіз.

Жолдарды жазу:

Біреу байланыс формасын жіберген кезде, оны дерекқорға сақтаңыз және сонымен бірге "Leads" қойындысына жол қосыңыз (күні, аты, поштасы, хабарлама), valueInputOption RAW режимінде spreadsheets.values.append арқылы. Google 429 қайтарса, экспоненциалды кідіріспен қайталаңыз; бәрібір сәтсіз болса, көріністі дерекқорда сақтап, кейінірек қайталаңыз.

Жиі кездесетін қателер

• Кестені сервис аккаунтының поштасымен бөлісуді ұмыту. Кілт дұрыс болса да, API рұқсат қатесін қайтарады.
• Кілтті фронтендте немесе репозиторийде сақтау. JSON кілті онымен бөлісілген әр кестеге қатынау береді. Қараңыз: API кілттерін қалай қауіпсіз ұстау керек.
• Пайдаланушы енгізуі үшін USER_ENTERED қолдану, бұл формула инъекциясына жол ашады.
• Әр сұрауда API-ді шақыру, сондықтан трафиктің алғашқы шыңында минуттық квотаға соғылу.
• Баған орындарына тәуелді болу. Біреу баған қосады, қолданба қате деректерді оқиды. Тақырып жолын оқып, атауы бойынша салыстырыңыз, немесе тақырыпты бекітіңіз.
• Кестені қажетінен кеңірек бөлісу. "Сілтемесі бар кез келген адам" оны ашық етеді.
• Кестені көп пайдаланушылы дерекқор ретінде қолдану. Бір уақыттағы жазулар мен жоқ рұқсаттар деректердің жоғалуына немесе ағуына әкеледі.

Тексеру тізімі

• Sheets API қосылған; сервис аккаунты жасалған
• Кесте сервис аккаунтының поштасымен қажетті ең төмен рөлмен бөлісілген
• Кілт пен кесте ID-і серверлік құпия ретінде сақталған
• Барлық шақырулар серверден жасалады
• Диапазондарда қойынды атаулары қолданылады
• Пайдаланушы беретін мәтін үшін RAW қолданылады
• Оқулар кэштелген; 429 кідіріспен өңделген
• Sheets қолжетімсіз болса, қолданба сынбай жұмыс істейді
• Қай жақ шынайы дерек көзі екені шешілген

Mythex-те Google Sheets

Mythex-те Sheets-пен жұмыс істеудің екі түрлі жолы бар. Коннекторлар Google аккаунтыңызды Mythex-ке байланыстырады, сондықтан агент сіз құрастырып жатқанда оны пайдалана алады, мысалы кестені оқып, одан бақылау тақтасын жасау; құжаттар credential Mythex-тің байланыс қызметінде қалатынын және ешқашан кодқа түспейтінін айтады (қараңыз: Коннекторлар, және Google сұраған әр рұқсатты мақұлдаңыз). Жарияланған қолданба кестені өз бетінше оқуы немесе жазуы үшін сенімді жол — осы нұсқаулықтағы жол: жоба құпиясы ретінде сақталған сервис аккаунты кілті және сервериңізден Sheets API шақырулары, Кез келген API-ді интеграциялау бөлімінде көрсетілгендей. Кестеден өсіп кетсеңіз, агенттен деректерді жоба дерекқорына көшіруді сұраңыз және соның үстіне бақылау тақтасын құрыңыз.

Сұрақтар